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Code Club is a nationwide network of volunteer-led after school clubs 
for children aged 9-11. 


We're always looking for people with coding skills to volunteer to run 
a club at their local primary school, library or community centre for an 
hour a week. 


You can team up with colleagues, a teacher will be there to support 
you and we provide all the materials you'll need to help get children 
excited about digital making. 


There are loads of ways to get involved! 


So to find out more, join us at www.codeclub.org.uk 
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earning to code is one of the most MagPi | 

profoundly life-changing things you : 

can do. So says Lucy Hattersley in her 

beginner's guide to coding, starting on page 14. 

She's right too; I distinctly remember the 

feeling of euphoria I got from finishing my first $ 

coding project from scratch. It must be like being SUBSCRIBE & 

a young Harry Potter learning of his life beyond 

the cupboard under the stairs. Realising that you SEE PAGE 28 FOR DETAILS 


have the power to conjure up something entirely 
new and unique from your fingertips is about as 


life-changing as it comes. 
While we lack the witches and broomsticks THIS MONTH: 


of the wizarding world, we're increasingly 
14 LEARN TO CODE 


surrounded by computers that do our bidding 
Make 2017 a journey of discovery! 
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and much of our thinking for us. It’s becoming 
urgently important that we understand their 


common tongue. While there’s a lifetime of 42 REMOTELY ACCESS YOUR PI 


learning out there, the magazine you're holding . . . 
) : f ; Learn how to use SSH in another Raspberry Pi 101 guide 
can - believe it or not - equip you with the 


skills you need to write just about any game or 70 USE DEBIAN + PIXEL ON YOUR PC 


nan : ; | 
application you can imagine. Yes, even that one! Test-drive your Raspberry Pi experience on a spare PC today! 


Russell Barnes 96 MAKE 2017 A YEAR FOR MAKING 
Managing Editor New Year's resolutions don't come any better than this 
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Learn how to remotely access your Raspberry Pi 
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An introduction to the Raspberry Pi Camera Module 


» MAKE A GPIO MUSIC BOX 46 


Program push buttons to make different sounds 


»INTRODUCTION TOCPART7 48 


Learn how to use arrays and strings in C 


» CREATE A HORSE RACE GAME 50 


Get yourselves to the derby with Pi Bakery 


» SHARE YOUR PI POWER 56 


Use BOINC to donate your Pi's resources to science 
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Sonic Pi returns this issue with sample stretching 
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See if anyone's been going into your room 
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Put a hedgehog on a trampoline in Scratch! 
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EBEN 
HONOURED 


Eben Upton receives his 
CBE after being placed 
on the honours list in June 
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Learn how to use the x86 release of Raspbian The teen programme from 
on your PC, included on our cover disc! Raspberry Pi has launched! 
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New York is 
one of the busiest 
cities on Earth, and 
noise pollution is 
a big problem for 
its inhabitants 


FEATURE 


, ounds of New York City 
is a novel project by New 
York University (NYU) to 


monitor noise pollution in the city. 


*Noise pollution is one of the 
topmost quality of life issues for 
urban residents in the United 
States," says NYU. “It has been 
estimated that nine out of ten 


The data recorded by the 
Raspberry Pi are being used to 
create a Mission Control Centre. 
Information from the network 
flows through the infrastructure 


that analyses the retrieved data. 
Machine learning techniques are 
being used to identify sources 
of noise pollution, such as police 
sirens or street music. 
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adults in New York City (NYC) are 
exposed to excessive noise levels.” 


To analyse the problem, NYU 
has set up Raspberry Pi devices 
with microphones to monitor 
audio levels around NYC. 

We caught up with Charlie 
Mydlarz, a senior research 
scientist working on the project. 
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Helped injured 
opponent win. 


*We are working with 
NYC agencies, including the 
Department of Environmental 
Protection, and we will provide 
them with an aggregated noise 
data stream so they can enforce 
the noise code more efficiently," 
explains Charlie. *We also work 
with the Department of Health 
and Mental Hygiene in a bid to 
uncover relationships between 
health and noise in the city." 


Sensor nodes 
“The sensor node is built around 
the Raspberry Pi 2B running a 
headless Jessie," Charlie reveals. 
Attached to the Raspberry Pi is 

a digital microphone. “All data 
is transmitted via WiFi," adds 
Charlie. It's currently running 
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The Acoustic Sensing Devices contain a Raspberry Pi 


THIS MONTH 
IN NUMBERS 


Noise pollution is one of the CODE CLUBBERS IN THE UK 
topmost quality of life issues for 


urban residents in the United States 4 ARE 
on the NYU network across and then encrypted using AES and 
its campus. RSA encryption. OQ GIRLS 


“The sensors themselves don’t “We have done a lot of work 
have a name," he tells us, “but I to maintain privacy on the 
usually call them Acoustic Sensing project, and have had an external 


Devices or ASDs. ‘Listening box? consultant confirm that street- 
sounds way too ominous!” level, intelligible speech at 
The team has worked hard to conversational levels cannot be 
ensure that the project doesn't picked up,” insists Charlie. “A 
encroach on privacy. *The audio person would have to shout at J 


data is collected in ten-second the sensor for the speech to be 
snippets, randomly separated intelligible, and that wouldn’t 


in time to ensure privacy is constitute a private conversation.” C ODE C L | | B S IN 
maintained,” says Charlie. These The team also deploy signs below 
audio snippets are compressed each node to inform people what PRIMARY SCHOOLS 


using the lossless FLAC encoder, they are doing. 
“As of today, we have 20 nodes 
up and running,” Charlie tells us. 


By the end of 2016 they should 
have 50 deployed, and by spring 
2017 there will be 100. 

“These poor little Pis have 
just survived the hot and humid 
YC summer and are about to 
experience the freezing winter,” 

says Charlie. “They’ve been 


fantastic so far and have spent 


ow IN LIBRARIES AND 
' COMMUNITY CENTRES 


New York University plans to deploy 
over 100 of the devices in its sensor : 
network next year take the winter too.” 
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The world's most popular IoT cloud platform adds Pi support 


Build your own Particle-connected, Pi-powered security camera 


article, a cloud platform 

for Internet of Things 

(particle.io), has added 
official support for the Raspberry 
Pi. With the popularity of IoT 
projects on the Pi, the world's 
most popular low-cost computer 
seems a natural fit for the world's 
most popular IoT platform. 

“Particle is a scalable, reliable, 

and secure Internet of Things 
device platform that enables 
businesses to quickly and easily 
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PI JOINS 


build, connect, and manage their 
connected solutions," comments 
Jonathan Gladbach, Particle's Head 
of Growth. 
Following a beta programme 
limited to 1,000 users at the end of 
November, the service will be made 
available to all Raspberry Pi owners. 
You can sign up for a free 
account on the website 
(magpi.cc/2fuAoM2) and 
download the software to your Pi 
running Raspbian. Using either the 


x Particle 


article Build web IDE or Particle 
Dev desktop application, you can 
then select your remote device 
and program it, with access to 
numerous community libraries. 
*Particle's tools are now used 
by 70,000 engineers in more than 
170 countries," says Jonathan. 
*[They] are being used by many 
Fortune 500 companies to 
develop and manage fleets of new 
IoT products." 

A key feature is the ability 
to run Arduino Wiring code on 
the Raspberry Pi: *No more 
complicated tooling, setup, or 
scripting to perform simple tasks 
like trigger a pin, blink an LED, 
or read a sensor value,” explains 
Jonathan. “With Particle’s 
Raspberry Pi Agent, you can now 
program in C and C++, making 
these tasks easy.” 

Webhooks are tightly integrated 
into Particle’s event system, 
and projects may be integrated 
with IFTTT, Google Cloud, or 
Microsoft Azure. 

Use cases for Particle include 
home automation, remote 
monitoring, resource management, 
triggers and buttons, and asset 
tracking. The Particle website 
includes Raspberry Pi tutorials 
(magpi.cc/2g7kxQB) to get you 
up and running with suggested 
projects, including a security 
camera (magpi.cc/2g7uCwH). 
Check out Adafruit’s demo video, 
too (magpi.cc/2g7ndxl). 


a) 


The Particle Dev desktop application allows you to work 
with local copies of your firmware files 
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Accessories for Raspberry Pi 


WD SMART CABLE MODULE 


Upgradeable hardware with built-in CM programming mode 
2xUSB ports 10/100 Ethernet jack 


802.11b/g/n Wi-Fi 


The Media Stick for Raspberry Pi Compute Module“ offers an 
easy way to quickly turn a TV or monitor into a powerful 
media hub or a custom digital display. 


Raspberry Pi Compute Module not included 
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This all-in-one lot edge node server offers onboard computing capabilities 


ds © WDLABS 
for autonomous projects like video recording, data logging, and more. 


wdlabs.wd.com/products 


11 MILLION -002 


Raspberry Pi sales pass another major milestone 


n 25 November, it was 

confirmed that total sales 

of the Raspberry Pi have 
now topped 11 million. 

Considering that Pi sales only 
reached the ten million milestone 
at the start of September, that 
means it’s taken less than three 
months to add a further million. 

Even more impressive, it turns 
out that this figure is only for 
the flagship Pi models: the B, B+ 
Pi 2, and Pi 3. “Those are only 
the $35 product,” Raspberry Pi 
Trading CEO Eben Upton tells 
us, “so there’s no A, no A+, no 
Compute Module, no Pi Zero.” 

He estimates that sales of the 
other Pi models total at least 
another million. 

The next milestone will be to 
bypass sales of the Commodore 
64, estimated at 13 million, for 
the Raspberry Pi to become the 
third best-selling computer 
of all time, behind the PC and 
Mac. “Neither of those are really 
catchable,” reckons Eben. Above Over 11 million Raspberry Pis have been made at the Sony factory in South Wales 


Eben Upt : f m 

CBE Says his PRO aspberry Pi co-founder earlier. In addition, “He asked 

reflects the work Eben Upton has received us how many we’d sold. I said 

of the Raspberry , " f Saat -— p 

Pi Foundation he CBE (Commander o 11 million. He said ‘Wow!’ It looks 
the Order of the British Empire) like someone noticed." 
medal from HRH Prince Charles Eben told us he might hang his 
during an investiture ceremony medal on the Christmas tree. “It 
on 25 November. certainly would be the prettiest 


Accompanied by his wife Liz and Christmas ornament I’ve got.” 
his parents, Eben described his visit While it's a great personal honour, 
to Buckingham Palace as a “fun day he says it also reflects the work of 
out." He reveals that he and Prince the Foundation and the many tens 
Charles chatted about a previous of people who have worked for it, 
event they had both attended at along with hundreds of volunteers 
Highgrove House a couple of weeks out in the community. 
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NEW OFFICIAL 


Updated Volume 2 includes Pi Zero content 


e’re proud to announce 
the release of The Official 
Raspberry Pi Projects Book 
Volume 2, complete with shiny 
foil cover. Inside are 200 pages 
absolutely stuffed with Pi projects, 
guides, and reviews to help you on 


The latest Pi 
Projects Book 
is out just 

in time for 
Christmas! 


ne Official 
RASPBERRY PI 
PROJECTS BOOK 


SW THL MAKERS OF TMi TH OFFICAL RASPBERRY PI MAGAZINE 


your Raspberry Pi journey. Unlike 
last year’s original Projects Book, it 
includes a ton of Raspberry Pi Zero 
content to get your teeth into, as well 
as an updated Getting Started guide. 
We know a lot of you love the first 
Projects Book and we really hope you 
enjoy this new edition of it. You 
can grab the Projects Book Volume 2 
right now from our online store 
(magpi.cc/MagPiStore) for £12.99, 
and is available from our app on 
Android and iOS for a discounted 
£5.99. It has alreaday made a great 
stocking filler for Pi enthusiasts, but 
it's also a great way to start the New 
Year! It’s also available as a free PDF, 
from magpi.cc/Back-issues. 


Young digital makers are invited to join the 
Pioneers programme 


The stories we shared that 
flew around the world 


magpi.cc/2fv8SMZ 


The MagPi has been 
translated into four new 
languages: French, Spanish, 
Hebrew, and Italian. Each 
new magazine is a bite- 
sized edition, containing 20 
pages of the best projects 
and features. 


magpi.cc/2fvdQJF 


Build your own equivalent to Nintendo's NES Classic, 
using an old game cartridge and a Pi Zero. Snazzy Labs’ 
video showing you how to do it has already racked up 
well over 200,000 views. 


magpi.cc/2fv8j5K 


Twitter magnified interest in this DIY digital microscope. 
The Post Apocalyptic Inventor stuck a Pi custom camera 
to the eyepiece of a standard scope for a low-cost 
solution that works amazingly well. 


January 2017 og? 


The 
new PiDrive 
models 
featurea 
micro SD card 


pre-loaded 


SERVER® 


Sci-fi star beams up a stellar Pi project 


et phasers to stun: using a Raspberry Pi 3 running 
Star Trek’s very own Raspbian, along with a hard 
Wil Wheaton has been drive, to ‘make it so’. 
building a Raspberry Pi home Asked by a Twitter follower 
media server. The American whether it could boost the 
actor, best known for playing efficiency of the warp core, Wil 
Wesley Crusher in Star Trek: responded, “If you add the right 
The Next Generation, was ‘hailing repository to apt.sources, it 
all frequencies’ on Twitter, can.” He also revealed that he’s 
@wilw, to announce the news to finding it hard to resist getting 
fans: “I’m having so much fun a Picade retro gaming system: WD PID RIVE 
with my Raspberry Pi weekend “It’s getting increasingly 
project.” Following an online difficult.” Well, as most retro 
tutorial by developer Mel Grubb games fans already know, 
(magpi.cc/2fIs36c), Wil is ‘resistance is futile’. 
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Featuring NOOBS preloaded on SD 


DLabs has launched the third generation of 

its PiDrive products, offering an affordable 

hard drive storage solution for the Raspberry 
Pi. Known as the ‘Foundation Edition’, the new range 
includes two hard drive options - 250GB and 375GB - 
along with a 64GB USB flash drive. 

While similar in format to previous PiDrive models, 
this edition features a micro SD card preloaded with 
the Raspberry Pi Foundation's NOOBS installer, 
enabling users to easily install Raspbian with PIXEL, 
or an alternative operating system, without the need 
to flash a memory card manually. 


WDLabs has launched 
the third generation of 
its PiDrive products 


“This third generation WD PiDrive solution uses a 
USB HDD or USB flash drive to run the OS and host 
multiple Raspberry Pi projects, instead of having to 
do this on a collection of micro SD cards," says Dave 
Chew, chief engineer at WDLabs. 

Available directly from wd.com, the PiDrive 
Foundation range is priced from $18.99 to $37.49. 


Wil Wheaton is hoping his Pi-powered home server will live long and prosper 
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SECURITY UPDATE 


Latest version of Raspbian OS beefs up security 


he Raspberry Pi 

Foundation released 

a new version of the 
Raspbian operating system on 
25 November 2016. 

The 1.1 release of Raspbian with 
PIXEL includes a number of fixes 
and adjustments. The new version 
of Raspbian also introduces a 
range of security measures. 

*We usually find a few small 
bugs and other issues as soon as 
the wider community start using 
it, and so we gather up the fixes 


and produce a 1.1 release a few 
weeks later," writes Simon Long 
on The Raspberry Pi Foundation's 
blog (magpi.cc/2gF9mhY). 

You can download the 
new image file from the 
Foundation's Downloads page at 
magpi.cc/1MYYTMo. Or update 
your existing Jessie OS using 
these commands in a terminal: 


sudo apt-get update 
sudo apt-get dist-upgrade 
sudo apt-get install -y pprompt 


HIPS Y 


PROTECT YOUR FAMILY, FINANCES & FILES AT HOME & ON THE GO 


DU. 


SHIELD FROM EXPLOITS 
Attackers working from 


outside your system private information 


PROTECT FROM PHISHING 


Invitations to reveal your 


BLOCK MALWARE 
Attacks that have been 
installed inside your system 


DEVELOPED BY THE INDUSTRY EXPERTS 


tdappcom 


Download Raspban 


RASPBIAN JESSIE WITH PIXEL 
———— — 


RASPBIAN JESSIE LITE 
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TAKING THE RASPBERRY PI TO THE NEXT LEVEL 


GIPSY 


ANYTIME, 
ANYPLACE 


Our products are built on the best of British small computer, using 
our decades of expert security experience. We provide 24 hour 
security management via the cloud connected Idappcom 
Security Operations Centre. 


Taking the Raspberry Pi to the Next Level of Cyber Protection 


Visit: www.ipssecurityrules.com Call: +44 (0) 203 355 6804 


Discover the joy and art of computer programming with your Raspberry Pi 


earning to code is one of the most profoundly 
life-changing things you can do. This has 
always been true, but learning to code is 
increasingly important in the modern world. 

The reason the Raspberry Pi was created was to 

challenge a drop in computer science applications 

at Cambridge University. Modern computers, and 
f^ especially games consoles, were fun and powerful, 

À but not easily programmable. 
The maker community fell in love with the 
Raspberry Pi, thanks to its cheap and hackable 
nature. Building and tinkering are the primary 
reasons we love Raspberry Pi. Great projects use a 
combination of hardware and software together. 

So, whether you're a hacker learning to make better 
projects, or a would-be coder looking for a better 
career, this feature is set to help you on your way. 

The good news is that you don't need to be a genius 
to know coding, just as you don't have to be a genius 
to read and write. It's actually pretty simple once you 
learn a few simple concepts like variables, branching, 
and loops. 

Perhaps you're brand-new to coding. Maybe you 
did a little BASIC in school, or used old languages like 
Pascal and Fortran. Or maybe you're already knee- 
deep in projects and just want to learn the language 
that controls them. 

Wherever you're coming from, we're here to 
walk you through the basic concepts of computer 
programming. We'll demystify the whole process of 
code, so you can get a better understanding of what's 
going on inside your Raspberry Pi. 
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Code Matters 


“| think everybody in this country should learn to program a 
computer,” said Apple's co-founder Steve Jobs, “because it 
teaches you how to think." 

Code is a critical layer in our lives that sits between us 
and the increasingly digital world that surrounds us. With 
just a small amount of understanding how code works, 
you'll be able to perform computer tasks faster and get a 
better understanding of the world around you. Increasingly, 
humans and machines are working together. 

Learning to use code and hardware is incredibly 
empowering. Computers are really about humanity; it's 
about helping people by using technology. Whether it's the 
home-made ophthalmoscope saving eyesight in India, or 
the Computer Aid Connect taking the internet to rural Africa, 
code on the Raspberry Pi is making a real difference. 

Coding also makes you more creative. It enables you to 
automate a whole bunch of boring and repetitive tasks in 
your life, freeing you up to concentrate on the fun stuff. 

It also teaches you how to solve problems in your life. 
Learning to how to put things in order, and how to break 
down a big, seemingly impossible task into several small 
but achievable tasks is profoundly life-changing. 

And if you're looking for a career boost, there's plenty of 
worse things to learn. "Our policy is literally to hire as many 
engineers as we can find,” says Mark Zuckerberg, CEO 
of Facebook. “The whole limit in the system is that there 
just aren't enough people who are trained to have these 
skills today.” 
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Python 2 and 
Python 3 are both 
commonly used. 
Python 3 is the 
future, so we're 
going with it. Lots 
of courses still teach 
Python 2, and it's 
not a bad idea to 
take a closer look 
atthe differences 
between the two: 
magpi.cc/2gP6zX3 


Python is an 'interpreted language: 
You write the code and then run the 
program. Under the hood, it's being 
translated and runs on the fly. Some 
languages, such as C and Java, are 
compiled. You write the program, then 
compile it to get a build file (written in 
machine code), then you run the build. 
It's a faff you can do without for now. 


r 


Discover the building blocks of software 
O and learn what goes on inside a program 


efore you go any further, let’s look at what a 

program actually is. The dictionary definition 

is a “set of instructions that makes a 
computer do a particular thing.” 

A computer program is a lot like a recipe. It has 
a list of ingredients, called ‘variables’, and a list of 
instructions, known as ‘statements’ or ‘functions’. 
You follow the instructions from the recipe one line at 
a time and end up with a tasty cake - and that’s no lie. 

The real miracle of computers, however, is that 
they can do the same thing repeatedly. So you can 
get a machine to bake a thousand cakes without ever 
getting tired. A program may contain loops that make 
it do the same thing over and over again. 

Programs also make decisions, and different paths 
through a program can be taken. Your recipe could 
make a scrummy chocolate cake or a delightful 
batch of doughnuts, depending on the variables (the 
ingredients) it has. 
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One thing that may surprise you when you begin 
programming is just how little you need to know to 
get started. With just a few variables, a smattering 
of flow, and some functions, you can get a computer 
doing all the hard work for you. 


Inside your Pi 

At the heart of your Raspberry Pi are billions of voltage 
switches known as binary digits (or ‘bits’ for short). 
There are 8,589,934,592 of them in its 1GB of RAM, to 
be exact. All these switches can be set to high or low, 
which is typically represented as o (for low or off) and 
1 (for high or on). Everything you see on the screen, 
hear from the speakers, and type on the keyboard is 
billions of switches being turned on and off. 

Obviously, it's not that easy for humans to talk 
directly to computers. It's possible to use machine 
language and send binary instructions directly to a 
computer, but this isn't where any sane person starts 
(or ends if they want to remain sane). 

Instead, we use a coding language to program. This 
is written using easy-to-understand functions like 
print(). These are then interpreted into machine 
language, which the computer understands. 

We're going to use Python to learn to code. Python 
is a truly great programming language. It has a rich 
syntax that's free from clutter; you don't have to 
worry about things like curly braces and static typing 
that crop up in more complicated languages like Java. 

With Python, you can just create code, run it, and get 
things done. Python is one of the languages found most 
commonly inside The MagPi, so learning it here will 
help you understand lots of the code used in projects. 
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IDE and IDLE 


You don't have to write Python programs using a text 
editor like Leafpad and run them in the terminal. 
Instead, you can use a neat all-in-one solution, known 
as an ‘IDE’ (integrated development environment). 

IDEs combine a text editor with program-running 
functionality. Often, they’ll include fancy features like 
debugging and text completion. 

Click Menu > Programming > Python 3 (IDLE), and 
you’ ll get a new window called ‘Python 3.4.2 Shell:’. 
This Shell works just like Python on the command line. 
Enter print("Hello World") to see the message. 

You can also create programs in a built-in file 
editor. Choose File > New File. Enter this program 
in the window marked ‘Untitled’: 


word1 "Hello " 
word2 "World" 
print(word1 + word2) 
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Above Python IDLE makes it easy to create programs and 
run them without having to use the command line 
Don't forget to include the space after ‘Hello’. Choose 
File > Save As and save it as hello.py. Now press F5 on 
your keyboard to run the program. (Or choose Run > 
Run Module). It’! display ‘Hello World’ in the Shell. 
The advantage of using Python IDLE is that you can 
inspect the program in the Shell. Enter word1, and 
you'll see ‘Hello’. Enter word2 and you'll see ‘World’. 
This ability to inspect and use the variables in your 
program makes it a lot easier to experiment with 
programming and detect bugs (problems in your code). 


Python comes 
pre-installed in the 
Raspbian operating 
system and you 
can use it at the 
command line 
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Variables are all-purpose containers that you use to store data and objects 


Python has five 
standard data types: 
@ Numbers 

e String 

@ List 

@ Tuple 

@ Dictionary 


You'll come 
across ‘foo’ and 
‘bar’ a lot when 
learning to code. 
These are dummy 
placeholders and 


don't mean anything. 


They could be zig 
and zag or bim and 
bam. Nobody's 
quite sure, but it 
might be related 
to the expression 
'fubar' from the 


Vietnamese war. 


f you've created a science project or 

experiment, you may have come across 

variables. In science, a variable is any factor 
that you can control, change or measure. 

In computer programming, variables are used to store 
things in your program. They could be names, numbers, 
labels, and tags: all the stuff your program needs. 

In Python, you write the name of a variable then a 
single equals sign and the word, number or object you 
want to put in it. 

Enter this code directly into the Shell: 


vire) c dl 
bar - 2 


Remember: the variable name is on the left, and the 
thing it contains is on the right. Imagine you've got 
two plastic cups, and you've scrawled ‘foo’ on the first 
and ‘bar’ on the second. You put a number 1 in foo and 
a number 2 in bar. 

If you ever want to get the number again, you just 
look in the cup. You do this in Python by just using the 
variable name: 


foo 
bar 


You can also print out variables by passing them 
into a print function: 


print(foo) 
print(bar) 
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Variables can also be used to contain ‘strings’. 
These are groups of letters (and other characters) 
that form words, phrases or other text. 

Creating a string variable in Python is pretty 
much the same as creating an integer, except 
you surround the text with single(' ') or double 
(" ")quotes. 

Using double quotes makes it easier to include 
apostrophes, such as print("Don?t worry. Be 
Happy"). This line would break after ‘Don’ if you used 
single quotes - print('Don?t worry, be happy') 
— so use double quotes for now. 


Why variables count 

Variables make it much easier to change parts of your 
code. Say you've got an excellent coding job at Nursery 
Rhymes Inc and you've written a classic: 


print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("We?ll all have tea") 


The head of marketing comes in and says "our data 
shows that Polly isn't trending with the millennial 
demographic." You say “Huh!” and he barks “Change 
Polly to Dolly.” 

You now have to go through and change the variable 
in all three lines. What a downer! But what if you’d 
written thousands of lines of code and they all needed 
to change? You'd be there all week. 

With variables, you define the variable once and 
then use it in your code. Then it's ready for changing 
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at any time: 
name - "Polly" 


print(name + " put the kettle on) 
print(name + " put the kettle on) 
print(name + " put the kettle on) 
print("We?ll all have tea") 


This code prints out the same classic nursery rhyme. 


But if you want to change the name of our character, 
you only have to change it in one place: 


name - "Dolly" 


...and the poem will update on every line. 


What's your type? 

When you create a variable in Python, it's 
automatically assigned a type based on what it is. You 
can check this using the type() function. In the shell 
interface, enter: 


foo - "Ten 
bar 


I 
[2 
© 


Now use the type() function to check the type of 
each variable: 


type(foo) 
type(bar) 


It will say «class 'str'» for foo, and «class 
'int'» for bar. This concept is important, because 
different types work together in a variety of ways, and 
they don't always play nicely together. 

For example, if you add together two strings they 
are combined: 


name - "Harry" 
job = "Wizard" 
print("Yer a " 


+ job + + name) 

This prints the message “Yer a Wizard Harry”. The 
strings are concatenated (that’s a fancy programming 
term for ‘joined up’). Numbers, though, work 
completely differently. Let’s try a bit of maths: 


6 
9 


number1 
number2 


print(number1 + number2) 
Instead of concatenating 6 and 9 together to give 


69, Python performs a bit of maths, and you get the 
answer ‘15’. 
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Type casting 
So what happens when you want to add a string and 
an integer together? 


variable? 


Variable names 


name - "Ben" 

number - 10 

print(name + number) 
should be lower- 


case words 
separated by an 
underscore ' . 


You'll get an error message: ‘TypeError: Can't 
convert 'int' object to str implicitly’. This error is 
because Python can't add together a string and an 
integer, because they work differently. Ah, but not 
so fast! You can multiply strings and integers: 


They can include 
numbers, but 

must start with a 
letter. You can call 
variables pretty 
much anything, but 
there's a small list of 
reserved keywords 
you should avoid 
(magpi.cc/2h7MH1y). 
It's a good idea to 
call them something 
that will be obvious 
when you use them 
in your program, like 
‘student_name’ or 
'person age. 


print(name * number) 


It'll print ‘Ben’ ten times: you'll get 
*BenBenBenBenBenBenBenBenBenBen'. 

If you want to print out ‘Ben10’, you'll need to 
convert the integer to a string. You do this using 
a str() function and putting the integer inside 
the brackets. Here we do that, and store the result 
in a new variable called number. as string: 


number as string - str(number) 
print(name + number as string) 


This code will print out the name 'Ben10'. This 
concept is known as 'type casting': converting a 
variable from one type to another. 

You can also cast strings into integers using the 
int() function. This is particularly useful when you 
use input() to get a number from the user; the input is 
stored as a string. Let's create a program that asks for 
a number and exponent and raises the number to the 
power of the exponent (using the *** symbol): 


number - input("Enter a number: ") 
exponent - input("Enter an exponent: ") 
result - int(number) ** int(exponent) 


Our first two variables, number and exponent, e 
are strings, while our third, result, is an integer. 
We could just print out the result: 


print(result) 


But if we wanted to include a message, we need to 
type cast result to a string: 

print(number + " 
" + exponent + 


raised to the power 
" is " + str(result)) 


Variables, types, and type casting can be a bit tricky at 
first. Python is a lot easier to use because it dynamically 
changes the type of a variable to match the thing you put 
in it. However, it does mean you have to be a bit careful. 
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These comparison 
operators are 
commonly used 

in conditions 

to determine if 
something is True 
or False: 


equal 

not equal 
less than 
less than 

or equal to 
greater than 
greater than 
or equal to 
less than or 
greater than 


omputers are great because they don't mind 
doing the same stuff over and over again. 
Their hard-working nature makes computers 
ideal for doing grunt work. 
When looking at variables earlier, we printed out 
this nursery rhyme: 


print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("We?ll all have tea") 


We didn't like the repetition of Polly, so we replaced it 
with a variable. But this code is foolish in another way: 
you have to write out the same print line three times. 

We're going to use a loop to get rid of the repetition. 
The first loop we're going to look at is a ‘while loop’. 
In Python 3 IDLE, create a new file and save it as 
polly.py; enter the code from the top of the next page. 

We start with two variables: 


name - "Polly" 
counter - 0 


There's a massive nerd debate about whether to use spaces or tabs when 
indenting code. There are valid arguments on both sides, which you can learn in 
this clip from HBO's comedy Silicon Valley (magpi.cc/2gZdeoM). Use spaces for 
now. When you're a hardcore coder, you can make the argument for tabs. 
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& Tor 


Then we use the while statement followed by a 
condition: counter « 3. 

On the next line down, you press the space bar four 
times to indent the code. Don't press the TAB key 
(see ‘Tabs or spaces? boxout). 


while counter « 3: 
print(name + " put the kettle on") 
counter = counter + 1 


The < symbol stands for ‘less than’. 
It checks if the item on the left is less than the 
item on the right. In this case, it sees if the variable 
counter (which starts at 0) is less than 3. This 
condition is known as ‘True’; if it wasn’t, it’d 
be known as ‘False’. 

Finally, enter the last line of code: 


print("We?ll all have tea") 


Save and run the program (press F5). It will print 
‘Polly put the kettle on’ three times and then ‘We’ll all 
have tea’. 


While, condition and indent 
There are three things here: the while statement, the 
condition, and the indented text, organised like this: 


while condition: 
indent 


Imagine a three-way chat between all three items 
in our polly.py program: 
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While: “Hey Condition! What's your status?” 
Condition: “True! The counter is 0. It's less than 3.” 
Indent: “OK, guys. I'll print out ‘Polly put the kettle 
on’ and increase the counter by 1. What's next?" 


While: “Hey Condition. What's your status?” 
Condition: “True! The counter is now 1.” 
Indent: “OK. I’m printing out another ‘Polly put 
the kettle on’ and increasing the counter by 1.” 


This goes on till the counter hits 3. 


While: “Hey Condition. What’s your status?” 
Condition: “False! The counter is now 3, which isn’t 
less than 3.” 

While: “OK guys. We're done!” 


The program doesn’t run the indented code, but moves 
to the single print at the end: ‘We’ll all have tea’. 


For and lists 
The next type of loop is known as ‘for’. This is 
designed to work with lists. 

Lists are a type of variable that contain multiple 
items (strings, numbers, or even other variables). 
Create a list by putting items inside square brackets: 


banana splits = ["Bingo", "Fleegle", 
"Drooper", "Snorky"] 


Now enter banana splits in the Shell to view the 
list. It will display the four names inside the square 
brackets. You can access each item individually using 
the variable name and square brackets. Enter: 


banana splits[O0] 


...and you'll get ‘Bingo’. Lists in Python are zero- 
indexed; that means the first item in the list is [0]. 
Here are each of the items. Type them into the Shell 
to get the names returned: 


* d f 
AÀ 
) m 
4 
) 


` 
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name = "Polly" 
counter = O 


while counter < 3: 
print(name + " put the kettle on") 


counter = counter + 1 


print("We?ll all have tea") 


banana splits[0] # "Bingo" 

banana splits[1] # "Fleegle" 
banana splits[2] # "Drooper" 
banana splits[3] # "Snorky" 


Zero-indexed lists can be confusing at first. Just 
remember that you're counting from o. A for loop 
makes it easy to iterate over items in a list. Create 
this program and save it as splits.py: 


banana splits - ["Bingo", "Fleegle", 
"Drooper", "Snorky"] 


for banana split in banana splits: 
print(banana split) 


It doesn't matter what you use as the variable in 
a for loop, as long as you remember to use it in your 
indented code. You could put: 


for dude in banana splits: 
print(dude) 


It's common to name the list as something plural 
(such as ‘names’, ‘pages’, and ‘items’) and use the 


singular version without the ‘s’ for the ‘in’ variable: 


‘for name in names’, ‘for page in pages’, and so on. 


Infinite 
loops 


You must be 
careful to change 
the counter in 
awhile loop, 

or you'll get an 
infinite loop. If 
you delete the 
line counter = 
counter + 1 
from our while 
loop, it will run 
forever: it never 
goes above 0, 

so the indented 
code runs over 
and over again. 
This bug is known 
as an ‘infinite 
loop’ and is a bad 
thing to have in 
your programs. 
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feature sae 


Bra 


You can combine 
conditions together 
using logical 
operators. 


and Both operands 
are true: (a and 
b) is True 
Any operator is 
true: (a or b) is 
True 
Checks if 
something is 
false: not (a 
and b) is True 
if both a and b 
are False. 


our programs have been slowly getting more 
powerful. We've learned to run instructions 
in procedural order, replaced parts of our 
program with variables, and looped over the code. 

But another important part of programming is 
called *conditional branching'. Branching is where a 
program decides whether to do something or not. 

Of course, a program doesn't just decide whether or 
not to do things on a whim: we use the sturdy world of 
logic here. 

The start of all this is the powerful ‘if? statement. 

It looks similar to a loop, but runs just once. The if 
statement asks if a condition is True. If it is, then it 
runs the indented code: 


if True: 
print("Hello World") 


Run this program, and it'll display ‘Hello World’. 
Now change the if statement to False: 


if False: 
print("Hello World") 


...and nothing will happen. 

Of course, you can't just write True and False. 
Instead, you create a condition which evaluates to 
True or False; a common one is the equals sign (==). 
This checks whether both items on either side are 
the same. Create a new file and enter the code from 
password1.py. This code is a simple program that 
asks you to enter a password; if you enter the correct 
password, ‘qwerty’, it displays ‘Welcome’. 
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Be careful not to confuse the equals logic operator 
== with the single equals sign =. While the double 
equals sign checks that both sides are the same, 
the single equals sign makes both sides the same. 
Getting == and = mixed up is acommon mistake for 
rookie coders. 


What else 

After if, the next conditional branch control you need 
to learn is ‘else’. This command is a companion to if 
and runs as an alternative version. When the if branch 
is True, it runs; when the if branch is False, the else 
branch runs. 


if True: 

print("The first branch ran") 
else: 

print("The second branch ran") 


Run this program and you'll see ‘The first branch 
ran’. But change True to False: 


if False: 

print("The first branch ran") 
else: 

print("The second branch ran") 


...and you'll see ‘The second branch ran’. Let's use 
this to expand our password program. Enter the code 
from password2.py. 

Run the program again. If you get the password 
correct now, you'll get a welcome message. Otherwise, 
you'll get an ‘incorrect password’ message. 
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Elif 

The third branching statement you need to know 

is ‘elif’. This statement stands for ‘else if’, and sits 
1 ) 

between the if and else sakemenis, Let’s look at an if attempt 

elif statement. Enter this code: 


password = “qwerty” 
attempt = input("Enter password: ") 


== password: 
print("Welcome") 


if False: 

print("The first block of code ran") 
elif True: password - "qwerty" 

print("The second block of code ran") attempt = input("Enter password: ") 
else: . 

print("The third block of code ran") if attempt -- password: 

print("Welcome") 
else: 


Run this program and you'll find it skips the first if 
statement, but runs the elif statement. You'll get ‘The print("Incorrect password!") 
second block of code ran'. 

The else statement doesn't have a True or False 


condition; it runs so long as neither the if or elif Writing FizzBuzz 
statements are True. (Note that the else statement here, The brief for our FizzBuzz is to print the numbers from 1 to 
as always, is optional; you can just have if and elif.) 100. If a number is divisible by three (such as 3, 6, and 9), 

But what happens if you change both the if and elif then you print ‘Fizz’ instead of the number; if the number A mark of a good 
conditions to True? Give it a try and see whether just is divisible by five, you print ‘Buzz’ instead. programmer is to 
if runs, or elif, or both. Experiment with removing the But if a number is divisible by both 3 and 5, such as ue commentin 
else statement and play around. It'll help you get the the number 15, then you print ‘FizzBuzz’. your programs. 
hang of the if, elif, and else statements. We're also introducing a new element in FizzBuzz: Comments are 

. the ‘and’ statement. This checks if two conditions used to explain 
FizzBuzz are both True: that the number can be divided by bits of your 
We're going to show you a common program used both 3 and 5. It only returns True if both conditions program to 
in computer programming interviews. It's a classic are True. humans. They 
called ‘FizzBuzz’, and it shows that you understand if, There are three main logical operators: and, or, are completely 
else, and elif statements. and not. The first two are relatively straightforward, ignored by 

First, you need to know about the modulo operator but the ‘not’ operator can be more confusing at first. the computer. 
(4). This is used to get the remainder from a division Don't worry about it too much; you'll get the hang of In Python, you 
and is similar to a divide operator. Take this function: it with practice. ESTER coMMent 

Enter the fizzbuzz.py code from page 25 to practise linenvithtahoch 

10 / 4 == 2.5 using if, else, and elif elements and logical operators. symbol (#), It can 


If we use a modulo instead, we get this: 


10 % 4 == 2 


| be ona line on 
Wy ANNIS it own, or it can 
D A come right after 
ss | m a line of code. As 
soon as Python 
Modulo turns out to be handy in lots of ways. You hits the #, it'll 


0, i 1 1 . 
can use% 2 to figure out if a number is odd or even: stop translating 


whatever follows 
10 % 2 == 0 # this is odd 


11 % 2 == 1 # this is even 


into machine code. 
Comments help 
other users to read 


This program works out if a number is odd or even: your program, but 


IEEE n el they will also help 
you understand 
what you're doing 


number - 10 


if number % 2 == 

print("The number is even") 
else: 

print("The number is odd") 


(long after you've 
forgotten), It's 

a good habit to 
use comments in 


your programs. 


OK - let's move on to FizzBuzz. 
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Create the building blocks of code and make more robust programs 


ou've come a long way since your first 
*Hello World'. Your programs now check 
for conditions and loop over themselves. 

You're now writing programs that are known as 
‘Turing complete’, named after Alan Turing, the father 
of computer science and artificial intelligence, who 
hacked the German Enigma code in WWII. 

Now we're going to take things a little further. 
We're going to introduce you to a form of modularity 
called functions. 

Functions are blocks of code that you write once 
and can repeat anywhere. It's a little like being able to 
write a block of text once, and then paste it whenever 
you need it. 


Spotting a function 

Python is packed with built-in functions, 
and you've already been using them in your 
programs. Commands like print(), len(), and 

type() are all functions. They're easy to spot: a 

small command starting with a lower-case letter 

» and followed by a pair of parentheses '()'. 


You can browse or download a copy of the Python 
documentation directly from the Python website 


at python.org/doc. Python has a whole bunch of 
built-in functions. You can view a list of all the built-in 
functions on the Python documentation website 
(magpi.cc/2gPsGK3). 


24 MagPi January 2017 


Using functions 
Let's take a look at a function called abs(). It stands 
for ‘absolute’, and returns the absolute value of any 
number you pass into it (the bit you pass in is called 
the ‘argument’). 

An absolute number is the positive of any number, so 
if you write abs(-2) you get 2 back. Try this in the Shell: 


abs(2) # returns 2 
abs(-2) # returns 2 


You can store the returned result as a variable: 
positive number - abs(-10) 


We find it easier to read a function backwards, from 
right to left. The value is passed into the parentheses, 
then the function cranks it and returns a new value. 
This is passed left and stored into the variable. 


Defining a function 

The great thing about Python is that you don't just 
use the built-in functions: you get to make your own. 
These are called ‘user-defined functions’. 

You create a function using the def keyword, 
followed by the function name and parentheses. 
Inside the parentheses, you list the parameters. 
These are the same as the arguments, only inside the 
definition they are called ‘parameters’. 


def function(parameter) : 
return parameter 
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Teature 


Our function here doesn't do anything; it simply 
accepts a parameter and returns it. 

At the end of the function definition is a colon (:). 
The function code is indented by four spaces, just like 
a loop or if/else branch. 

The code inside the indentation runs when you call 
the function. Functions typically include a return 
statement which passes back an expression. 


Working functions 
We're going to create a function that prints the lyrics 
to Happy Birthday. 

Type out the happy. birthday.py code from the 
listing, then run it. In the Shell, enter: 


happy. birthday("Lucy") 


This function call uses the string ‘Lucy’ as the 
argument. This string is passed into the function as 
the parameter and is then available for use in the 
indented code inside the function. 


Return statements 
Many functions don't just run a block of code; they 
also return something to the function call. 
We saw this in abs(), which returned the absolute 
value of a number. This can be stored in a variable. 
In fact, we're going to recreate the abs() function, 
So you can see how it's working behind the scenes. 
In maths, you invert a positive/negative value by 
multiplying a negative number by -1, like this: 


10 * -1 = -10 
-10 * -1 - 10 


We need to create a function that takes a number 
as a parameter and checks if it's negative. If so, it 
multiplies it by -1; if it's positive, it simply returns the 
number. We're going to call our function absolute(). 

Enter the code in absolute.py. When the function 
hits either of the return statements, it returns the 
value of the number (either on its own or multiplied 
by -1). It then exits the function. 

Run the absolute.py code and enter the following 
in the Shell: 


absolute(10) 
absolute(-10) 


Our last program listing is a classic known as 
‘FizzBuzz’; as mentioned on page 23, it will help you 
to understand if, else, and elif. 

You also need to know the modulo operator (X) for 
FizzBuzz. This operator returns the remainder from a 
division. If you don't know how modulo works, watch 
this video (magpi.cc/2h5XNRO). 

Now work through the code in fizzbuzz.py. 
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def happy birthday(name): é 
count = 0 Happy iri thday.py 
while count « 4: 
if count !- 2: 
print("Happy birthday to you") 
else: 
print("Happy birthday dear " + name) 
count += 1 


def absolute(number): 
if number < @: 
return number * -1 
else: 
return number 


7lbsolute.py 


count = 0 
end = 100 


Tizzbuzz.py 


while count « end: 
if count % 5 == 0 and count % 3 == 
print ("FizzBuzz") 
elif count X 3 == 0: 
print("Fizz") 
elif count X 5 == 0: 
print("Buzz") 


else: 
print(count) 
count += 1 


Going further 

Here are some resources you will find useful. 

GPIO Zero Essentials — magpi.cc/2bA3ZP7 

This Essentials guide book explains how the GPIO Zero Python module 


provides access to a bunch of features. These are used to hook up 
electronics to your Raspberry Pi via the GPIO pins. 


FutureLearn - magpi.cc/2hs5Sthf 
The Raspberry Pi Foundation has two new online training courses: 


Teaching Physical Computing with Raspberry Pi and Python, and 
Teaching Programming in Primary Schools. 


Learning Python - magpi.cc/2h2opWC 

This tutorial provided by The Raspberry Pi Foundation 

has files you can download. You download the file, EJ e 
called intro.py, using this command in a Terminal: Y 

wget http://goo.gl/0ZDOdX -O intro.py 

--no-check-certificate. Open 


the intro.py file in IDLE; all the 
instructions are in the file. 
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Importing 


Stand on the shoulders of giants by importing 
other programmers’ code 


Pygame 


If you want to 

learn more about 
Pygame, check out 
Make Games With 
Python, our free 
Essentials Guide to 


the Pygame module. 
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his being the modern world, you’re not 
supposed to do all the work on your 

own. Instead, you will often stand on the 
shoulders of other programmers who have done the 
groundwork for you. 

Your programs can import code created by other 
people using the import statement. This enables 
you to import modules and use their functions - only 
they’re now known as ‘methods’. 

You import the module at the command line, and 
then access the functions using dot notation. This is 
where you list the module, followed by a dot (.), then 
the method. 

A common module to use is math. This allows you 
to access lots of maths methods. Open a Python Shell 
and enter: 


import math 


You now have access to all the methods in math. 
You won't notice any difference, but if you type: 


type(math) 
...it will say ‘<class 'module'>’. Let's try out dot 
notation now. Type math followed by a dot and the 
name of the method (function) you want to use: 

math.sqrt(16) 

This gives the square root of 16, which is 4. 


Some methods have more than one argument. The 
math.pow() method raises a number to an exponent: 
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math.pow(64,3) 


This returns 262144.0. 

You can also access constant values from a module, 
which are fixed variables contained in the module. 
These are like functions/methods, but without 
the parentheses. 


math.pi 


This returns pi to 15 decimal spaces: 
3.141592653589793. 


math.e 


This returns Euler’s number to 15 decimal spaces: 
2.718281828459045. 

It's also possible to import methods and constants 
from modules using from. This enables you to use 
them inside your programs without dot notation 
(like regular functions). For example: 


from math import pi 
from math import e 
from math import pow 


Now, whenever you type pi or e, you'll get pi and 
Euler's number. You can also use pow() just like a 
regular function. You can change the name of the 
function as you import it with as: 


from math import pi as p 


Now when you enter p you'll get pi to 15 decimal 
spaces. Don't go crazy renaming functions with as, 
but it's common to see some methods and constants 
imported as single letters. 

By creating your own functions, and importing 
those created by other people in modules, you can 
vastly improve the capabilities of your programs. 

We're going to take everything we've learnt and use 
it to create a game of Pong; this is one of the world's 
first videogames. 

Write out the code carefully in pong.py. Here you'll 
find variables, functions, loops, and conditional 
branching: all the stuff we've talked about. Hopefully, 
you'll now be able to decipher most of this code. 

If you're interested in taking Pong further, this 
program is similar to a version of a Pygame program 
by Trever Appleton (magpi.cc/2hgkOUX). His version 
has a scorecard and more advanced code. We've kept 
ours simple so it's easier to start with. 

Hopefully this isn't the end of your Python, or 
programming, journey. There are lots of places 
you can learn programming from. And we'll have 
more programming resources for you in every issue 
of The MagPi. 
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import pygame, sys 
from pygame.locals import * 


# Set up game variables 

window width - 400 

window height - 300 

line thickness - 10 

paddle size = 50 # try making this smaller for a harder game 
paddle offset - 20 


# Set up colour variables 
black = (0 ,0 ,0 ) # variables inside brackets are ‘tuples’ 


white = (255,255,255) # tuples are like lists but the values don't 


change 


# Ball variables (x, y Cartesian coordinates) 

# Start position middle of horizontal and vertical arena 
ballX = window width/2 - line thickness/2 

ballY - window height/2 - line thickness/2 


# Variables to track ball direction 
ballDirX = -1 ## -1 = left 1 = right 
ballDirY = -1 ## -1 = up 1 = down 


# Starting position in middle of game arena 
playerOnePosition = (window_height - paddle_size) /2 
playerTwoPosition = (window_height - paddle_size) /2 


# Create rectangles for ball and paddles 

paddle1 = pygame.Rect(paddle offset,playerOnePosition, line 
thickness,paddle size) 

paddle2 = pygame.Rect(window width - paddle offset - line. 
thickness, playerTwoPosition, line thickness,paddle size) 


ball - pygame.Rect(ballX, ballY, line thickness, line thickness) 


# Function to draw the arena 
def drawArena(): 
screen.fi11((0,0,0)) 
# Draw outline of arena 
pygame.draw.rect(screen, white, ( 
(0,0) , (window width,window height)), line thickness*2) 
# Draw centre line 
pygame.draw.line(screen, white, ( 


(int(window width/2)),0), ((int(window width/2)),window height), ( 


int(line thickness/4))) 


# Function to draw the paddles 
def drawPaddle(paddle): 
# Stop the paddle moving too low 
if paddle.bottom > window_height - line_thickness: 
paddle.bottom = window_height- line_thickness 
# Stop the paddle moving too high 
elif paddle.top < line_thickness: 
paddle.top = line_thickness 
# Draws paddle 
pygame.draw.rect(screen, white, paddle) 


# Function to draw the ball 
def drawBall(ball): 
pygame.draw.rect(screen, white, ball) 


# Function to move the ball 

def moveBall(ball, ballDirX, ballDirY): 
ball.x += ballDirX 
ball.y += ballDirY 
return ball # returns new position 


# Function checks for collision with wall and changes ball 
direction 
def checkEdgeCollision(ball, ballDirX, ballDirY): 

if ball.top == (line thickness) or ball.bottom == (window. 
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height - line thickness): 
ballDirY = ballDirY * -1 
if ball.left -- (line thickness) or ball. 
right -- (window width - line thickness): 
ballDirX = ballDirX * -1 
return ballDirX, ballDirY # return new direction 


Pong. py 


# Function checks if ball has hit paddle 
def checkHitBall(ball, paddle1, paddle2, ballDirX): 
if ballDirX == -1 and paddlei.right == ball.left and 
paddle1.top < ball.top and paddle1.bottom > ball.bottom: 
return -1 # return new direction (right) 
elif ballDirX == 1 and paddle2.left == ball.right and 
paddle2.top « ball.top and paddle2.bottom > ball.bottom: 
return -1 # return new direction (right) 
else: 
return 1 # return new direction (left) 


# Function for AI of computer player 
def artificialIntelligence(ball, ballDirX, paddle2): 
# Ball is moving away from paddle, move bat to centre 
if ballDirX -- -1: 
if paddle2.centery « (window height/2): 
paddle2.y += 1 
elif paddle2.centery > (window_height/2): 
paddle2.y -= 1 
# Ball moving towards bat, track its movement 
elif ballDirX == 1: 
if paddle2.centery < ball.centery: 
paddle2.y += 1 
else: 
paddle2.y -=1 
return paddle2 


# Initialise the window 
screen = pygame.display.set mode((window width,window height)) 


pygame.display.set caption( Pong’) # Displays in the window 


# Draw the arena and paddles 


. drawArena() 

. drawPaddle(paddle1) 
. drawPaddle(paddle2) 
. drawBall(ball) 


. # Make cursor invisible 
. pygame.mouse.set visible(0) 


. # Main game runs in this loop 
. while True: # infinite loop. Press Ctrl-C to quit game 


for event in pygame.event.get(): 

if event.type -- QUIT: 
pygame.quit() 
sys.exit() 

# Mouse movement 

elif event.type == MOUSEMOTION: 
mousex, mousey = event.pos 
paddle1.y = mousey 


drawArena() 
drawPaddle(paddle1) 
drawPaddle(paddle2) 
drawBall(ball) 


ball - moveBall(ball, ballDirX, ballDirY) 
ballDirX, ballDirY - checkEdgeCollision( 
ball, ballDirX, ballDirY) 
ballDirX - ballDirX * checkHitBall( 
ball, paddle1, paddle2, ballDirX) 
paddle2 - artificialIntelligence (ball, ballDirX, paddle2) 
pygame. display.update() 
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Subscribe in print for six or 12 months to receive this stunning free gift 


Subscribe today and receive: 
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| MATT LONG 
& MARK NICHOLS 


Matt Long and Mark Nichols (pictured) 
are Microsoft cloud solution architects 
who work on the Pegasus Mission. 

| pegasusmission.com 


EGASUS 
tae NORTH 
B AMERICAN 
SEIT AGLE 


The wheels are 
milled from 
solid aluminium 


NENNEN This land speed record-attempting jet car has 
Mau a Raspberry Pi sitting right behind the driver 


of over 800mph 


It consumes up 
to 90 gallons 


per minute nside the cockpit of one The current world record stands Brandyn Bayes, team member. 
during a run of the most remarkable at 763.035mph. This was set in *Starting with the battered 
machines on Earth sits a October 1997 by British Royal Air hulk of a Cold War-era jet 
Raspberry Pi. Force pilot Andy Green, driving his plane, we have developed one 
The North American Eagle jet-powered Thrust SSC car. of the most sophisticated racing 
is an ongoing attempt by an “We have a mission to break machines ever.” 
American team to reclaim the the World Land Speed Record of The North American Eagle 
land speed record. 763mph (1227.93km/h),” says started life as a Lockheed F-104 
F Starfighter. “It was used as a chase 
Right Sensor data 
from inside the plane,” reveals Brandyn. These are 


cockpit is gathered 


: planes used to follow experimental 
by a Raspberry Pi 


aircraft and measure engineering 
data. It followed some of the 
greatest experimental aircraft in 
history, among them the X-15 
and the Northrop-Grumman B-2 
Stealth Bomber. 

The particular F-104 that has 
been transformed into a superfast 
car was designated 56-0763. By 
1998 it was “beyond a shambles,” 
says Brandyn. *The North American 
Eagle project gave it new life, so 
that it could once again be one of 
the fastest machines on Earth." 
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The Raspberry Pi is placed 
inside the cockpit, right 
behind the driver's head 


High-speed Pi 
While North American Eagle is 
gunning for the speed record, the 
Pegasus Mission behind it usually 
has its eyes to the sky. 

“Pegasus Mission uses a high- 
altitude balloon as a delivery 


PEGASUS AND THE NORTH AMERICAN EAGLE 


a Microsoft cloud solutions 
architect) to the North American 
Eagle project. “We asked to join 
the North American Eagle team," 
Mark tells us. 

The Pegasus Mission balloon 
“provides a rich and interesting 


The North American Eagle 
started life as a Lockheed 
F-104 Starfighter 


system to carry a payload," 
reveals Matt Long, a Microsoft 
cloud solution architect. 
The balloon is *packed with 
meteorological sensors to stream 
telemetry and control flight 
operations in real time." 

It's this expertise in real-time 
communication that attracted 
Matt and Mark Nichols (also 
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experience for users viewing 
the flight as it happens," 
Mark explains. *We started with 
the idea that the Pegasus team 
could provide a real-time view 
of what was happening with the 
vehicle to a global audience." 

“For this project I built a custom 
device that was installed in the 
cockpit of the vehicle,” reveals 


Aluminium wheels are 
attached to the jet, 
turning it into a car 


The North American Eagle 
is a Lockheed F-104 jet 
with its wings removed 


Mark. That device was a Raspberry 
Pi 3 running Windows 10 IoT 

Core. The software was written 

in C# as a Universal Windows 
Platform application. 

“Microsoft has been a partner 
supporting North American Eagle 
for quite a while," says Mark. 
“Volunteers got together to build 
this hardware, software, cloud, 
mobile, and web app capability." 

The main aim of the Raspberry 
Pi was to analyse the car during its 
test run. “It gathered real-time 
sensor data," says Mark. GPS, 
atmospheric, acceleration, and 
sound level data was gathered by 
the Raspberry Pi and sent to the 
Microsoft cloud. 

The Pegasus team could 
“evaluate the benefits of 
real-time data reporting and 
analysis in combination with the 
goals of the North American Eagle 
team," he explains. 
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The more entertaining aspect 
was the real-time interaction with 
Observers during the test run. 
*People using [our mobile] apps 
could also send goodwill messages 
through the cloud and out to the 
car, where they were shown on 
an LCD display," says Mark. The 
messages were displayed in a 
screen behind the driver. 

Mark also placed a GoPro camera 
behind the driver to record the 
user messages on the screen. *The 
driver could not see them while 
driving,” he explains, “as that 
would be a distraction, but the 
camera could see the display and 
the cockpit.” 

Naturally, the team needed to 
filter out inappropriate messages. 
“The system is configured to 
check a user message for profanity 
by calling a third-party SaaS 
service, Web Purify,” says Matt. 
“Tf the message passes, then it’s 
sent back into the system and 
onto the device in the cockpit 
for display. 


“The extra benefit [of the 
camera] is that it also gave us a 
front view out of the cockpit,” 
continues Matt. This video was 
used during a debug session 
with Jessi Combs (one of the test 
drivers) after her first run. 

“We also invested in two drones 
to record video, which gave us a 
great field of view during runs, as 
well as recording other aspects of 
the event and its remote location,” 
adds Matt. 


Technology matters 
“The technology that makes this 
real-time and scalable is Azure,” 
Matt reveals. 

“Azure provides a delivery 
mechanism for global 
communications in real time,” 
he explains. “We can capture 
the telemetry from the device, 
messages for users, and analyse 
or even replay data exactly 
as it occurred.” 

Matt tells us that North 
American Eagle’s comprehensive 
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on-board telemetry can be 
uploaded to Azure and viewed as 
a time-series event. “A team of 
around 20 Microsoft volunteers 
built mobile applications on 
Xamarin for iOS, Android, and 
Windows mobile, and a website in 
Azure App Services." 

*Since day one, people have said 
this project was just a little crazy,” 
comments Brandyn. “Perhaps 
that's a bit of an understatement, 
yet we couldn't agree more. It's 
that very adventuring spirit that 
has pushed us to continue to go 


further, to do something few would 


ever dare." 

Microsoft Research enabled the 
team to stream live telemetry to 
fans as the vehicle raced across 
the empty desert. “We were 
able to share over 500 million 
points of telemetry to over 4,500 
people on Jessi's first run alone," 
reveals Brandyn. 

*We received messages from 
users in Australia, New Zealand, 
UK, France, Norway, and the USA. 


One of the users watching Jessi 
Combs's first run sent a message 
to the device with her approximate 
top speed before she stopped. 
“While we didn’t break the 
records we had hoped for,” says 
Brandyn, “what we found was a 
reminder of why we love racing: 
the undeniable rush of adrenaline 


when things go right, despite the 
setbacks along the way.” 

“The North American Eagle 
team, Ed Shadle, and Jessi Combs 
have pushed themselves to the 
limit in the race for a land speed 
record,” adds Matt. “In the process, 
they have made us all proud 
members of the human race.” 


The 
North American 
Eagle uses its jet 
engine to achieve 
astonishing speeds 
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Clodagh's 
Instagram 
documented 
the entire 
process 


The dress was 
redesigned 

to improve 
comfort and 
functionality 


The Raspberry 
Pi records 
touch and 
keywords 


It then uploads 
this data to its 
SQL database 


Conductive 
thread was 
used to create 
'sectors' 


n her website, Clodagh 

O’ Mahony describes 

herself as a “multi- 
disciplinary designer with 
experience in product, graphic, and 
UX/UI design, as well as illustration 
and media production.” 

Having completed her BSc in 
Product Design and Technology at 
the University of Limerick, Clodagh 
went on to study for her master’s 
degree at the same establishment, 
this time in Interactive Media. This 
is where the Raspberry Pi comes in. 

For her thesis project, 

Clodagh created a dress and an 
accompanying website to comment 
on the progression of social media 
interaction — the idea that it’s 
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CLODAGH O'MAHONY 


Masters student and newly appointed 
teacher of Creative and Innovative 
Design Technology, Clodagh is also a 
master rower and archer. 
clodaghomahony.com 


All components are located 
at the back of the dress 


Different colours represent 
touch to different body 
parts, recording this data 
to the Raspberry Pi 


The aim was for a dress that 
would still be fashionable 
and comfortable, despite 
the additional tech 


A SPECULATIVE 
SOCIAL MEDIA 
PLATFORM 


Clodagh O’Mahony’s university thesis project records touch 
and voice data to award points for social interaction 


getting harder and harder to ‘hide’ 


on platforms such as Facebook 
and Twitter due to the sheer 
amount of personal information 
we pump into our timelines. 
Whereas a person could once 
create an entirely new persona 
through the predominantly text- 
based interaction of blogs and 
chat rooms, we now live a more 
visual existence online. Photo, 
video, and emojis have replaced 
textual communication, adding 
more ‘face’ to the name, and 
inevitably adding more reality. 
With this in mind, Clodagh set out 
to design *a wearable connected 
platform that introduces what 

is sold as a ‘purer’ form of social 


media. The quantitative data 
means users would have to 

go to extraordinary lengths 

to misrepresent their lives, 
thereby making its information 
more reliable than that of 

its competitors." 

Clodagh created a corporation 
named ‘QBee’, an abbreviation of 
Queen Bee, with the associated 
honeycomb theme playing a 
significant part in the look of 
both the dress and website. This 
corporation, if given true life, would 
provide a range of wearable tech — 
similar to her dress - that would 
allow for the recording of social 
interaction data, updating it to the 
wearer's online QBee account. 
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>STEP-01 


The aim of the build is to record 
physical interactions between the 
wearer and the people with whom 
they come into contact in the real 
world. A touch to the waist, for 
example, would be recorded with 
a certain set of points, whereas 
a touch to the back would record 
another. Alongside this physical 
interaction data, a microphone 
is used to listen out for any of a 
series of keywords that are listed 


>STEP-02 


activates the dress to glow a warm 
purple, a touch to the hip turns it 
green, and so on. 

The dress went through a couple 
of redesigns throughout the process 
of the build, all documented on 
Clodagh's Instagram account 
(magpi.cc/2eJgHuZ), allowing for 
improvements to cost, comfort, and 
usability factors. The original dress, 
though fitting exactly to the design 
plan of colour-related sectors, 


A wearable connected platform 
that introduces what is sold as 
a purer form of social media 


as either positive or negative, 
whereupon the relevant point 
data can be recorded. 

The build incorporates an 
Adafruit 12-key capacitive touch 
sensor breakout board, Pimoroni 
Blinkt, fibre optics, and a Raspberry 
Pi, all fitted within a beautiful 
hexagonal 3D- printed casing. 

Clodagh's aim was to use the 
Blinkt and fibre optics to add 
colour to the data recording: 
the touch of a hand to the waist 
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wasn't very comfortable. This led 
Clodagh to create another. Though 
the second dress doesn't offer 
exactly the same functionality, 

it does look the way she wanted, 
and still uses the Blinkt, though 

in a slightly different manner. 
Touch the new dress in any of 

the sectors and the Blinkt runs 
through a rainbow sequence until 
the touch is concluded: it is enough 
to demonstrate the idea of data 
recording and capacitive touch. 


>STEP-03 


Above Clodagh experimented with multiple 3D-printed cases, 
finding the ideal location for the tech to be housed 
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Projects 


SELF-PLAYING " 


This handcrafted wooden instrument can play any MIDI tune 


> Wendell first 
tried making 
a MIDI wine 
glass player 


» The organ took 
about three 
years to build 


» He bought the 
blower on eBay 
for $80 


» Pipes range 
from 9 to 40 
inches in length 


» He's now 
rebuilding 
the organ in 
solid oak 


xperienced woodworker 
Wendell Kapustiak needed 
all his carpentry skills to 
create this impressive self-playing 
pipe organ (magpi.cc/2fMacLy). 
*The most fundamental [problem] 
was that I had no idea how a 
pipe organ actually worked," 
admits Wendell, who eventually 
based its mechanical workings 
on a project by Matthias Wandel 
(woodgears.ca). The most difficult 
part was making the 42 wooden 


Each of 42 handcrafted 
wooden pipes produces 
a different musical note 


When triggered, solenoids 
open their respective pipe 
valves to play notes 


The solenoids are wired 
indirectly to an Arduino Due 
receiving data from a Pi 
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pipes, which span three-and- 
half octaves, since each one has 
unique dimensions to produce the 
correct pitch. For this, Wendell 
used information provided by 
Raphi Giangiulio's YouTube videos 
(youtu.be/-mibK Dp-ZY). 

The pipes are linked via PVC 
plumbing to a wind chest powered 
by a Kooltronic KBR125 blower, 
as used in data centres. *I had 
originally tried a small shop vac as 
a blower," Wendell tells us. *It had 


> -—— — 


two problems. The first was that it 
was very noisy; the second was that 
it ran hot. When I enclosed it ina 
box to control the noise, it got so 
hot that my first one burned out.” 
To make it play, each wooden 
pipe has a valve opened and 
closed by a solenoid, triggered 
from an Arduino Due via a power- 
boosting driver board. The ‘brains’ 
of the operation is a Raspberry 
Pi, which performs three main 
functions. As well as a graphical 


=. 
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user interface for selecting music 
to play, it converts the MIDI 
binary files into delay/note-on/ 
note-off commands, plus musical 
directions: “The Raspberry Pi 
takes into consideration tempo 
changes and any other subtleties 
in note timing, and converts them 
into a number of microseconds,” 


The Raspberry Pi takes into 
consideration tempo changes 
and any other subtleties 


explains Wendell. *In this way, 
the Pi has done all the heavy 
lifting as far as calculations go." 


Above A home-built driver board with 
transistors is used to boost the power from 
the Arduino output to trigger the solenoids 


a sample in about 20 minutes and 
it worked a treat.” 

Another issue involved the 
spacing of the pipes, which 
Wendell discovered could interact 
with each other if placed too 


closely together. *I suddenly 
understood why organs were 


Projects 


MAKING SWEET 
PIPED MUSIC 


>STEP-01 EE. 
pe 


designed wit 


h the pipes in a few 


Another Python prog 


ram is then 


used to send this data to the 


Arduino via USB. 
While the high-tec 


h side of the 


project proved fairly hassle-free, 
the physical engineering was more 


problematic. One difficulty was 


rows but spread out, not bunched 


together.” He also reversed the 


overall layout 


to put the solenoids 


at the front, so listeners can see 
them operating the valves. He 


has since add 
makes it muc 


ed some LEDs: “It 
h easier to follow 


the wind pressure regulator, which 
originally had a bellows-type 
mechanism. “I was trying out a few 
different designs, trying to develop 
one that was mechanically simple 
and dependable while producing a 
very stable pressure.” Fortunately, 
Wendell’s friend Jim, a retired 
HVAC engineer, stopped by and 
suggested a new approach, using a 
weight-controlled door as used in 
ventilation systems. *I whipped up 
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what's going on than just watching 
the solenoids.” 
The finished pipe organ 


generated a lot of interest from 


attendees at 


the Orlando Maker 


Faire. *I think most people were 
able to walk away with some 
level of insight as to how the 


combination 


of the old technology 


of the pipe organ and the new 


technology of 


the computer and 


microcontrol 


er fit together." 


>STEP-03 
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BRIAN BRANDAW 


A 25-year veteran of the 

IT industry, Brian is highly 
experienced in Linux and 
enjoys playing around with 
his Pi at home. 


24 WINNER! 
LEVEL MONITOR 


Automated water collection and monitoring through the power of 
Raspberry Pi - and the winner of Initial State's PIoT Challenge 


The system is wired up 
to a ProtoZero board 
on the Pi Zero 


he Raspberry Pi is no 

stranger to automation, 

and if you've read 
enough issues of this magazine 
you'll have seen plenty of home 


> It took 
four months 
on-and-off 
to build 


> Brian reckons 
he could 
rebuild one 
in about 
four hours 


> The ProtoZero 
board allows 
you to build 
circuits direct 
to the GPIO 


> It's accessible 
and can be 
controlled 
wirelessly 


> Brian has other 
Pis monitoring 
parts of his 
property 


automation projects that use it. 


This automa 
different, th 
water level i 
tanks, a solu 
Brandaw fro 

“Being on 


tion project is a little 
ough: measuring the 
n a couple of water 
tion devised by Brian 
m Texas. 

a rural lot, we rely on 


a private well for our water," Brian 
explains. *The quality is quite poor 
and the well has been unreliable 

at times. We took advantage of 

the metal roof on the barn and the 
existing rain gutters and installed 
two rainwater collection tanks. 
We added standard float valves to 
these to fill water troughs for the 
horses. This arrangement worked 
well until we ran out of water in the 
tanks! There is no easy means to 
track tank level.” 

All the traditional methods are 
visual, requiring you to go out to 
the tanks to check them on a fairly 
regular basis, although some can 
be used at a distance. 

“I wanted to devise a means 
to monitor tank levels to know 
when things were running low," 
continues Brian. *We can also 
measure water consumption by 
looking at how the water level 
changes over time.” 
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The pressure sensor 
gets its reading 
from the tank 


It can be operated 
wirelessly from 
another system 


pi NEL " 
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mo 


fat 


WATER TANK LEVEL MONITOR 


MONITORING WATER 


Under pressure 
The pressure sensor at the bottom of 
the tank is constantly under pressure, 
although this varies as the water level 
goes up and down. 


As we live in 2016, computer- 
aided monitoring was on the 
table. Brian's method was rather 
ingenious: instead of measuring 
the water level at certain points, he 
measured the pressure of the water 
at the bottom of the tank. With a 
few extra calculations to take into 


I wanted to devise a means to 
monitor tank levels to know 
when things were running low 


account atmospheric pressure and 
the size of the tank, the volume of 
water could be calculated. 

“T used a Pi Zero as the 
platform to read the pressure 
sensor (via an analogue-to- 
digital converter), calculate the 
tank volume, and post the data to 
InitialState for dashboarding and 
alerting," Brian tells us. 

His experience with Linux 
throughout his career made him 
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Light reading 

The Pi Zero reads the voltage levels on the 
two outputs with the help of an analogue- 
to-digital converter. The GPIO cannot 
measure it natively. 


more comfortable creating the 
project, basing it on a similar 
solution employing an Arduino 
that he'd seen a few years ago. This 
way he managed to save money on 
proprietary solutions as well. 

“Tt was tricky to build, but not 
because of the complexity of the 


solution,” Brian notes. “The box 
I chose is rather small, so it took 
some time to squeeze it all in 
there. The biggest challenge is the 
tight space on the ProtoZero board. 
I'm not the best at soldering, so 
it’s been slow going at times.” 
Brian reports that the solution 
works well, with only a minor 
repair required after he damaged a 
connection. In the future he plans 
to upgrade these connectors to 


Projects 


Simple geometry 

The Pi Zero uses fluid dynamics and the 
measurements of the tank to determine the 
volume of the water in the tank. This can be 
charted to keep track of consumption. 


Above The whole thing is connected to the 
bottom of the tank in a small grey box 


make them a little more rugged, 
but otherwise it looks like his 
project has helped out enormously 
with his water supply. 
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Components 
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pi-top 
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Battery Life 


13.3" 
HD Screen 


Modular 
Components 


526499 


without Raspberry Pi 
ex VAT 
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|- to Worldwide shipping available in green or grey at www.pi-top.com 
Stay up to date with our latest news by following our social media 


CEEDuniverse 


CEEDuniverse is a world of fantasy 
grounded in computing reality! After 
crash Landing on a strange new planet 
you will first encounter 'drag and drop' 
coding puzzles that improve your 
computational thinking skills. 


Discover more about the planet you've 
landed on and the civilisation that used 
to inhabit it while Learning harder and 
more complex concepts in fun and 
engaging ways! Before Long you'll be 
writing your own conditional 
statements, Loops and functions. Find 
out more about CEEDuniverse at 
www.pi-top.com 


pi-topCODER 


Influenced by the workflow of makers 
and hackers, pi-top presents 
pi-topCODER - an integrated code editor 
which allows you to learn, write and test 
code all in one view. With intuitive 
syntax highlighting, dynamic views and 
customizable themes it makes for a 
versatile Learning tool for your projects. 


pi-topCODER also has every Raspberry Pi 
Foundation lesson plan created and will 
track and save your progress as you go 
through dozens of fun hardware and 
software projects. 
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pi-topPROTO pi-topSPEAKER 
pi-topPROTO is a HAT compatible Give a voice to your pi-top device 
Add-on Board for your pi-top or with pi-topSPEAKER! 
pi-topCEED that allows you to 
prototype electronics. Create a * Modular design, attach up to three 
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Terminal = Bt & 


9 o pi@raspberrypi: ~ 
Book:~$ ssh pi@192.168.0.19 


The Cgatheatictty of host '192.168.0.19 (192.168.0.19)' can't be established. 

ECDSA key fingerprint is SHA256:k2RP2BuKYuu1uF79n1WT8Sv«6ZGLF 3mg3ryH4z0/oSE. 

Are you sure you want to continue connecting (yes/no)? yes 

Warning: Permanently added '192.168.0.19' (ECDSA) to the list of known hosts. Y 
pi@192.168.6.19's password: - 


The programs included with the Debian GNU/Linux system are free software; 


the exact distribution terms for each program are described in the 
individual files in /usr/share/doc/*/copyright. 


Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent 

permitted by applicable law. 

Last p Tue Dec 6 10:14:12 2016 from 192.168.0.38 

pigrasp pi: ls m 


Basco Pi Configuration - 


System Interfaces | Performance Localisation 
Camera Enabled *) Disabled 
SSH *) Enabled Disabled 
VNC Enabled *) Disabled 
SPI Enabled *) Disabled 
I2C Enabled *) Disabled 
Seria Enabled *) Disabled 
1-Wire Enabled *) Disabled 
Remote GPIO Enabled *) Disabled 
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Category 
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Logging 
Terminal 
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Features 
Window 
Appearance 
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Translation 
Se! 


Colours 


Rlogin 
SH 


About 


Basic options for your PuTTY session 


Specify the destination you want to connect to 


Host Name (or IP address) Port 
192.168.0.19 22 
Connection type R 
J) Raw ) Teinet ©) Rlogin O Serial 
Load, save or delete a stored session 
Saved Sessions 
Defaut Settings Load 
Save 
Delete 


Close window on exit 


Aways () Never 


OOO tucy@lucy-macBook: - 


locyglucy-M $ ssh 
The authenticity of host 
ECDSA key fingerprint is 
kare you sure you want to 


p1$192.168.0.19 

'192.168.0.19 (192.168.0.19)' can't be established. 
SHA256 : k2RP2BuKYuu1uF 79n1HT8Sv«6ZGLF 3ng3ryH4z0/oSE . 
continue connecting (yes/no)? yesi 
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System Interfaces | Performance | Localisation 
Camera *) Enabled Disabled 
SSH *) Enabled Disabled 

NC Enabled *) Disabled 
SPI Enabled *) Disabled 
12C Enabled *) Disabled 
Seria Enabled *) Disabled 
1-Wire Enabled *) Disabled 
Remote GPIO Enabled *) Disabled 

Cancel OK 
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Tutorial STEP BY STEP 


MAKE A PUSH BUTTON 


MUSIC BOX 


Use two or more tactile push buttons to play different sound samples 


n this easy electronics project, we’ll use push 
buttons to make a GPIO music box that triggers 
different sounds when we press the buttons. 


>STEP-01 

Get some sounds 

Open a Terminal window and create a new folder: 
mkdir musicbox. Switch to it with cd musicbox. Now 
we need to source some sound samples. While there 
are many public domain sounds online, we’ll use some 


GPIO Zero 


1x solderless 
breadboard 


2x push buttons 


3x male-to- 
female jumper 
wires 


2x male-to-male 


jumper wires 


Headphones 
or speakers 
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When pressed, the 
push button pulls 
the connected 
GPIO input pin 
(pulled high by 
default) Low 


Both buttons (and 
any more you want 
to add) sharea 
common ground 
connection via the 
‘—' rail 


of Scratch’s built-in percussion sounds, already 
present on the Pi. In your Terminal, enter mkdir 
samples, then change to that directory: cd samples. 
Now copy the Scratch percussion sounds with: 


cp /usr/share/scratch/Media/Sounds/ 
Percussion/* . 


>STEP-02 

Play a drum 

First, we'll create a simple Python program to play a 
drum sample repeatedly. Open Python 3 (IDLE), create 
a new file, and enter the code from ch4listing1.py. 
Save the file in your musicbox folder. Press F5 to run 
the program and listen to it play. If you can't hear it, 
you might need to alter your audio configuration; in a 
Terminal, enter amixer cset numid=3 1 to switch it 
to the headphone socket, or amixer cset numid=3 1 
to switch to the HDMI output. 


>STEP-03 

Wire up a button 

Turn off the Pi to start building a circuit. Place a 
push button so it straddles the central groove of 
the breadboard. One leg is connected to GPIO pin 2, 
and the other to the common ground rail on the 
breadboard, which in turn is wired to a GND pin. 

We'll make a sound play when the button is pressed. 
Open a new file in Python 3 IDLE, enter the code from 
chAlisting2.py, and save it in your musicbox folder. 
At the start, we import the Button class from GPIO 
Zero, and the pause class from the signal library. We 
assign the button variable to GPIO pin 2, with button 
= Button (2). We tell the sound to play when the 
button is pressed, using button.when pressed - 
drum. play. Finally, we add pause() at the end so that 
the program will continue to wait for the button to be 
pressed. Run the program and every time you press 
the button, the drum sound should play. 
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Below Each time you press a button, the assigned sound sample 
will play through a connected speaker 


>STEP-04 

Add a second button 

We’ ll now add a second button, as in the diagram. 
Wire it to GPIO 3 and the ground rail. Open a new file 
in Python 3 IDLE, enter the code from ch4listing3.py, 
and save it in musicbox. Note that rather than 
assigning the Button objects and sounds to the pins 
individually, we're using a dictionary structure to 
assign their numbers to sound samples: 


sound pins - ( 
2: Sound("samples/DrumBizz.wav"), 
3: Sound("samples/CymbalCrash.wav"), 


We then create a list of buttons on all the pin 
numbers in the sound pins dictionary: buttons - 
[Button(pin) for pin in sound pins] 

Finally, we create a for loop that looks up 
each button in the dictionary and plays the 
appropriate sound: 


for button in buttons: 
sound - sound pins[button.pin.number] 
button.when pressed - sound.play 


Run the program and press each button to hear a 
different sound. 


>STEP-05 

Add more buttons 

The way we have structured the program makes it 
easy to add extra buttons and assign them to sound 
samples. Just connect each button to a GPIO number 
pin (not any other type) and the ground rail, as before. 
Then add the GPIO pin numbers and sounds to the 
dictionary, as in the following example: 
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MUSIC BOX 


chellisingl.py 


import pygame.mixer 
from pygame.mixer import Sound 


>PYTHON 3 


DOWNLOAD: 
magpi.cc/2bhwqlH 


pygame.mixer.init() 
drum - Sound("samples/DrumBuzz.wav") 


while True: 
drum.play() 


chellisting2.py 


from gpiozero import Button 
import pygame.mixer 

from pygame.mixer import Sound 
from signal import pause 


pygame.mixer.init() 
button - Button(2) 
drum - Sound("samples/DrumBuzz.wav") 


button.when pressed - drum.play 
pause() 


chellisting3.py 


from gpiozero import Button 
import pygame.mixer 

from pygame.mixer import Sound 
from signal import pause 


pygame.mixer.init() 


sound pins - ( 
2: Sound("samples/DrumBuzz.wav"), 
3: Sound("samples/CymbalCrash.wav"), 


buttons - [Button(pin) for pin in sound pins] 
for button in buttons: 
sound = sound pins[button.pin.number] 
button.when pressed - sound.play 


pause() 


sound pins - ( 
2: Sound("samples/DrumBizz.wav"), 
3: Sound("samples/CymbalCrash.wav"), 
4: Sound("samples/Gong.wav"), 
14: Sound("samples/HandClap.wav"), 
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AN INTRODUCTION TO C 
ARRAYS AND STRINGS 


How to handle arrays (lists of values) and strings (lists of letters) in C 


KEEP INSIDE 
YOUR ARRAY 


One of the 
nastiest 
sources of 
crashes and 
bugs in C is 
creating an 
array and then 
writing past the 
end of it. The 


compiler wont 
stop you writing 
to memory 

off the end of 
an array, and 
doing so can 
have serious 


consequences. 
Always make 
sure your array 
indices fit inside 
your array. 


Below Array 
elements are 
stored sequentially 
in memory, with 
the array name 

a pointer to the 
first element. 
Multi-dimensional 
array elements 
are stored with 
the elements with 
neighbouring 
values in the 
rightmost index 
next to each other 


he variables we’ve looked at so far are all 
single numeric values. In this instalment, 
we're going to look at how C handles lists 
of values, and that leads into using lists of letters to 
store and manipulate text strings. 

An array is a variable which stores multiple values 
of the same type; the individual values are accessed 
by indexing the array. An array can have one or more 
dimensions; a one-dimensional array is a single list of 
values, while a two-dimensional array is a list of lists 
of values, and so on. 

An array is declared in C by putting the size of each 


dimension in square brackets after the variable name. 


So: 

int a[10]; 

is a list of 10 integers, while 
int b[5][6]; 


is a list of five lists, each containing six integers. 
When accessing the elements inside an array, the 
array index - the number inside the brackets - starts 
at 0. So the integers contained within a above are 
referred to as a[0], a[1], a[2] and so on, up to a[9]. 


Arrays and pointers 

The name of an array is effectively a pointer to the 
first element of the array. An array is a contiguous 
block of memory which contains all the elements 
in order, so you can use a pointer to access it. 


f 
| a[0] aft] a[2] a[3] a[4] a[5] a[6] a[7] a[8] | a[9] 
b 
Y = Aa MÀ — T “| 
L b[o1] | b[O)2] | b[O)3] | b[O][4] | b[O)5] | b[1)O] | b[1]1] | b[1)(2] | b[1)[3] | 
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Here’s an example: 


#include <stdio.h> 
void main (void) 
{ 
int a[10]; 
int count; 
for (count = 0; count < 10; counter) 


( 


a[count] = count * 10 + count; 


} 

printf ("The first and second elements 
of a are Xd and %d\n", a[0], a[1]); 

printf ("Or, as pointers, Xd and %d\n", 
*a, *(a*1)); 


} 


This fills the ten values of a with the numbers 
0, 11, ... and then reads a[0] and a[1]. It then reads 
the same values using a as a pointer; running the code 
shows that they are identical. 

With a multi-dimensional array, you need to 
consider how the compiler arranges the dimensions in 
memory. The elements at the rightmost index of the 
array are grouped together. With the array b[5][6], 

b itself points at b[0] [0]. b+1 points at b[0][1], b+5 
points at b[0] [5], and b+6 points at b[1][0]. 

You can initialise an array at the same time as you 

declare it by putting the values in curly brackets: 


int a[10] = ( 0, 11, 22, 33, 44, 55, 66, 77, 88, 99 ); 


This only works when the array is first declared; once 
it exists, you can't use this shortcut and will need to 
iterate through the array, setting each value in turn. 


Strings 

In C, a string is an array of single characters. 

A character is a specific type in C, called char - this 
holds a single byte, storing an ASCII character. 

A string with ten bytes would be: 


char mystring[10]; 
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14 printf (*or, 


Or, to initialise it at the same time: 
char mystring[10] = "thestring"; 


A string in C must end with a byte set to zero, and 
the memory required to hold this final zero (called the 
string terminator) must be allocated when you declare 
the string. So mystring, declared as an array of ten 
chars, can only hold nine or fewer letters.. 

You can use the index in square brackets to access 
individual characters in a string, or you can use a 
pointer. Here’s an example using pointers to join 
two strings together: 


#include <stdio.h> 
void main (void) 
{ 
char str1[10] = "first"; 
char str2[10] = "second"; 
char str3[20]; 
char *src, *dst; 
src = stri; 
dst = str3; 
while (*src != 


srctt; 
dst++; 
} 
src = str2; 
while (*src !- 0) 
{ 
*dst-=5*sre: 
src; 
dst++; 
} 
*dst = 0; 
printf ("Xs + Xs = %s\n", stri, str2, str3); 


We initialise two strings, str1 and str2, and 
we allocate an empty string, str3. We create a pair 
of char pointers, and point src at the start of str1 
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9 Functions 1 include <stdio.h> 
2 
@ main [3] 3 void main (void) 
4 { 
5 int a[10]; 
6 int count; 
7 
8 for (count = 0; count « 10; count++) 
9 
10 &[count] = count * 10 + count; 
) 


13 printf (*The first and second elements of a are *d anfi d\n" 
as pointers, *d and “Sd\n", 


by its ind 


= pi@raspberry:~ 
, alo], a(1)); | File Edit Tabs Help 
*a, *(a*1)); 


mystring 


Tutorial 


An array declaration, showing 
the type, the name, and the 


number of elements 


An array can be accessed 


ices inside square 


brackets, or as a pointer 


Above Strings are stored as an array of single characters, 
with the element after the last character set to zero 


and dst at the start of the empty str3. We loop, 
copying from src to dst and incrementing both 
pointers, until we find the zero that terminates 
str1. We then point src at str2, and do the same 
thing again until we find the zero at the end of 
str2. Finally, we write a zero to the end of str3 
to terminate it. 

Note the format specifier used to print strings - 
%s is used to print a string, and will display every 
character from the pointer supplied as an argument 
up to the first terminating zero. (To print a single 
character, you can use the format specifier %c.) 


Writing to strings 

Because the name of a string variable is only a pointer 
to the first character of the string, you can't use 

an equals sign to set the value of a string. You can 
initialise a string variable at the time you declare 

it, as above, but to set it later, the easiest way is the 
sprintf function. This is like printf; the difference 
is that the first argument it takes is the name of a 
string variable, and it writes to that instead of to the 
command line: 


#include <stdio.h> 
void main (void) 


{ 
int val = 12; 
char string[50]; 
sprintf (string, "The value of val is %d\n", val); 
printf ("%s", string); 
} 


The sprintf function adds the terminating zero 
at the end of any string it creates. 


J 


KEEP INSIDE 
YOUR STRING 


As with arrays, 
it's even easier 
to write off the 
end of a string 
and to corrupt 
memory 
elsewhere as 
a result. If in 
doubt, declare 
your string 
variables with 
more space 
than you think 
you'll need, 
and make sure 
that what you 
are writing 

into them 
actually fits. 


NAMES ARE 
POINTERS 


Remember that 
the name of an 
array or a string 
is just a pointer 
to the first 
element of the 
array or string 
in question, and 
can be used 

in the same 
way as any 
other pointer; 

it can be 
incremented 
and 
decremented, 
or 
dereferenced 
to find the 
value to which 
it points. 
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1 - Raspberry Rake C O 3- Not Quite Pi 
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ball bearings 


» 8x 15mm M3 
hex pillars 


» Five-way ribbon 
cable 


» Perspex and 


MEE Will ‘Raspberry Rake’ or ‘Not Quite Pi’ be the first to the winning line? 


» 5mm by 17mm 
strip pine 
and glue 


» 16x M3 solder 
tag washers 


> 16x M3 nuts 


» 16« Pan head, 
120mm, M3 
machine screws 


Shows the two points 
the ball must visit to 
advance your horse 


Tilt the box to guide 
the ball between 
the contacts 


e remember the ‘roll a ball’ horse race game 

from amusement parks with great fondness, 

so this month we thought we would create a 
two-player race game inspired by it. In the original 
you had to roll balls up a ramp into a hole and, 
depending on what hole the ball dropped into, your 
horse advanced a certain distance. You could have up 
to 20 wooden horses racing each other, with a prize 
for the winner. When the game was reset, all the 
horses moved backwards to the starting line again. 


THEPIDERBY Tutorial 


PLAYER 02 PLAYER 02 


GPIO 22 GPIO 17 
01 


00 
GPIO 10 GPIO 24 


Gnd Gnd 


02 
03 


GPIO 11 GPIO 27 ~ om) 


GPIO 9 GPIO 4 


Fig 1 


Our game 
As the original attraction was very big, things had to 

be scaled down drastically to fit in the Bakery. First off, BUILDING THE GAME BOXE S 
the number of players has been reduced to just two, 
and the wooden horses have been transferred to on- 
screen graphics. Finally, in order to reduce the size even 
further, the skill element has been miniaturised as a 
small ball bearing puzzle. Each time the ball bearing 
is manoeuvred between two requested positions, your 
horse advances, and the first to the finishing line 
wins. Unlike other race games we’ve made in 

the Pi Bakery, this one isn’t against the clock but 
another opponent. The increasing excitement and 
pressure of the race makes precise control of the ball 
bearing increasingly difficult, and that’s not allowing 
for unsportsmanlike nudges from the other player. 


The interface 
The game interface is simple enough. There are four 
pairs of nuts in the playing box and as the ball bearing 
is brought to rest against a pair of them, it completes 
a circuit and grounds a pulled-up GPIO pin. This is 
then read by the Raspberry Pi and if it's the position 
you've been asked to reach, your horse advances. The 
wiring diagram is shown in Fig 1; as this is a two- 
player game, you will need to make two of them. We 
avoided the pins GPIO 2 and 3 as there's a strong pull >STEP-01 

up wired to these, so they needed better contact with Gathering the materials 

the ball to register a touch than the other pins. The The two boxes are 100mm by gomm, and you need to cut this from 6mm 
alignment of the contact nuts was made so that it was plywood. Also, cut an identical size of acrylic sheet for the cover. Clamp the 
more difficult to go from one position to the other, two together when drilling the pillar holes to make sure they line up. Then 
thus requiring more skill. The construction details are cut eight lengths of 5mm by 17mm strip pine, 90mm long, for the sides. 
shown in the step-by-step guide. 
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Tutorial 


The resources 

The graphics for the horses were taken from a cut- 
out supplement, printed in the Boston Sunday Globe 
in September 1905, by RF Ayers; this is now well out 
of copyright. This cut-out featured two horses in 
mid-gallop, curiously carrying the numbers ‘one’ 
and 'three' on the saddle cloth. We have named the 
first horse ‘Raspberry Rake’ and the third ‘Not Quite 
Pi’, which we thought were suitable racing names. 


N 
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These horses were cut out electronically in a graphics 
package, and the background made transparent. 
Then they were reduced to just 196 by 136 pixels. The 
graphic of a track was drawn with a finishing post and 
line, and then a front rail was drawn with transparent 
sections between the rails. Finally, a sequence of 
graphics was drawn to indicate the required path of 
the ball bearing for each challenge. We also gathered 
a series of sound effects from the internet to help the 
game along. 


Playing the game 
The graphic by the horse name shows the two points 
the ball bearing must visit to advance the horse. The 
filled orange circle indicates the current target for 
your ball: only when you visit the start position, and 
then the end one, will the horse move. When you 
have just visited the start position, there will be a 
horse whinnying sound, and then you get the horse 
galloping sound and animation when you visit the 
last position. When the horse advances, not only 
does it go forward, but it also moves slightly up and 
down in a galloping motion; this mimics the original 
fairground version. When one of the horses crosses 
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Above Move the ball bearing as shown to advance your horse | bud | inve e o9 renews aoe ea © Serene e tes 
the finishing line, the winning margin is calculated E | | 
and printed using the correct horse racing terms: a 5 l | 
head, short head, length, and so on. Then the horses inl i | 
are wound back to the start with an accompanying ® | Q 
ratchet sound just like the original, and the race can l t i 
start again. At any time, pressing the RETURN key I 
: : mm 
will restart the race. We found occasionally that a 100mm 
ball would sit on the contacts but still not make an j al 


electrical connection. In that case, a small vibration 
of the box soon made a good connection. 
>STEP-03 


The software Drill the base 


The diagram shows the view into the tray; you might be better off 
marking the back and drilling from that side. Wire up the nuts and bolts 
to the Raspberry Pi's GPIO lines, using the solder tag washers, and test 
the connections are correct before fitting the acrylic cover. We used a 


The derby.py code listing is shown overleaf; this and 
the accompanying graphics are on our GitHub page 
(magpi.cc/1NqgJjmV). Like a lot of our projects, it’s 


written with the Pygame framework, and follows a small piece of double-sided sticky foam to fix the ribbon cable to the 
pattern familiar to regular readers. The showPicture back of the box. 
function first draws the track, then the two horses, 


and then the front rails; the last bit is the horse's m ill 
name and the distance to the finishing line, along : 
with the current state of where the ball should go. 
You'll notice that the variables describing some 
positions have two or three simple additions, rather 
than a single number. This makes it a lot easier to 
spot where the individual offsets are applied when 
developing the code, but you could pre-add them if it 
worries you. The movePhase variable list shows if the 
current target for the ball is at the start or the end of 
the line. The horse is checked at each movement to 
see if it has crossed the winning line, and there's also 
provision for the unlikely event of a dead heat. 


Taking it further 

You can modify the amount of movement a horse 
makes each time, thus requiring more or fewer ball 
movements per game. The game could easily be 
extended to more players; with each player needing 


four GPIO ports, there are ample resources for six > STEP-04 

players without resorting to any extra electronics. Finishing off 

You could replace the single horse graphic with 2 . Make sure to clean off the ball bearings with some solvent, as finger 
number of frames to make smoother, more realistic grease can result in the ball failing to make a good contact. You can 
movement like we did in the Olympic Swimming game paint around the nuts with Bare Conductive paint to make a more 


(The MagPi #48); however, the original idea was to reliable contact if you wish, but allow at least a day for this to dry. 
reproduce the mechanical fairground attraction. 


Tutorial WALKTHROUGH 


61. dInc[n] -=1 
derby.py 627 gallop[n] - gallopAdv(gallop,n) 


63. showPicture(distance,gallop) 
01. # Pi Derby - Horse race game 64. if checkForFinish(distance): 
02. # By Mike Cook - November 2016 65. restart = True 
03. 66. time.sleep(4.0) 
04. import pygame, time, os, random 67. 
05. import wiringpi2 as io 68. def moveDetect(dis): 
06. 69. global dInc, puzzle, moveTarget 
07. pygame.init() # initialise graphics interface 70. move = -1 
08.  pygame.mixer.quit() Hil for n in range(0,2): 
09. pygame.mixer.init(frequency=22050, size--16, We move = checkInput(n) # look at ball switch 
channels=2, buffer=512) Tele if move !- -1 : 
10. 74. # check if it is a valid move 
11. os.environ['SDL VIDEO WINDOW POS'] = 'center' 75. if move == moveTarget[n] : 
12. pygame.display.set_caption("The Raspberry Pi Derby") 76. if movePhase[n] == 1 : # move complete 
13.  pygame.event.set allowed(None) 775 dInc[n] = 50 # move this * 3 
14.  pygame.event.set allowed([pygame.KEYDOWN, pygame .QUIT]) 78. gameSound[1].play() 
15. screen = pygame.display.set_mode( [942,466], 0,32) 79. last = moveTarget[n] 
16. textHeight = 36 ; textHeight2 = 24 80. puzzle[n] = random.randint(0,11) 
17. font - pygame.font.Font(None, textHeight) 81. while last == moveState[puzzle[n]][9] : 
18.  font2 = pygame.font.Font(None, textHeight2) 82. puzzle[n] = random.randint(0,11) 
19; 83. moveTarget[n] = moveState[puzzle[n]][9] 
20. random.seed() ; winningPost = 704 84. movePhase[n] = 0 
21. ballPins = [ [17,24,4,27],[22,10,9,11 ] ] 85. else : 
22. targetGx = [ 18,102,18,102 ] 86. moveTarget[n] = moveState[puzzle[n]][1] 
23. targetGy = [ 18,18,102,102 ] 87. movePhase[n] = 1 
24. gallopInc = [1,1] ; gallop- [9,0] 88. showPicture(dis,gallop) # update move graphic 
25. diInc = [0,0] # distance increment 89. if n == 
26. puzzle = [5,5] ; restart = True 90. gameSound[4].play() 
27. moveTarget = [1,1] ; movePhase = [0,0] 91. else : 
28. 92. gameSound[5] .play() 
29. def main(): 93. 
30. global restart,dInc, gallop, puzzle,moveTarget ,movePhase 94. def gallopAdv(gallop,n): 
31. initGraphics() 95. global gallopInc 
32: initGPIO() 96. gallop[n] += gallopInc[n] 
33. #print "The Pi Derby" 97. if gallop[n] > 6 or gallop[n] «e: 
34. distance - [-120, -120] 98. gallopInc[n] - -gallopInc[n] 
35. showPicture(distance, gallop) 99. return gallop[n] 
36. while True: 100. 
375 checkForEvent() 101. def checkForFinish(d): 
38. if restart : 102. if d[0] »-winningPost or d[1] »-winningPost: 
39. gameSound[3].play() 103. gameSound[2].play() 
40. windBack(distance) 104. finish(d[0] - d[1]) 
41. pygame.mixer.fadeout(1000) 105. time.sleep(3.0) 
225 time.sleep(3.5) 106. return True 
43. distance[0] - -120 ; distance[1] - -120 107. else : 
44. gallop[0] = € ; gallop[1] = 0 108. return False 
45. gallopInc[0] = 1 ; gallopInc[1] = 1 109. 
46. dInc[0] - 0 ; dInc[1] - € 110. def windBack(d): 
47. puzzle - [5,5] qe wind - 4 
48. moveTarget - [1,1] ; movePhase - [0,0] 112. while d[0] >= -120 or d[1] >= -120: 
49. gameSound[0] .play() 113. showPicture(d, gallop) 
50. showPicture(distance,gallop) 114. checkForEvent() 
51 time.sleep(5) 1157 for n in range(0,2): 
527 restart = False # show Puzzle 116. if d[n] >=-120: 
53. showPicture(distance,gallop) 1177 d[n] -= wind 
54. 118. 
55: moveDetect (distance) 119. def checkInput(player): 
56. if dInc[0] or dInc[1] : 120. ball - -1 
57- for n in range(0,2): 121. for pin in range(0,4): 
58. if dInc[n] : 122. if io.digitalRead(ballPins[player][pin]) -- 
59, distance[n] += 3 123. ball - pin 
60. if dInc[n] : 124. return ball 
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1257 187. else : ang (LO : 
126. def initGPIO(): 188. return "a nose" 
27  N RY 2 189. P ! 
128. io.wiringPiSetupGpio() 190. def drawWords(words,x,y,f) : 
129. except : 191. if f == 0: DO DAD 
130. print"start IDLE with 'gksudo idle' from command line" 192. th - textHeight “9P 
1317 os. exit(1) 193. else : 
132. for player in range(0,2): 194. th - textHeight2 "RU 
133% for pin in range (0,4): 195: textSurface = pygame.Surface( JEU 
134. io.pinMode(ballPins[player][pin],?) (14,th)) CIO 2 
1357 # input enable pull up 196. textRect - textSurface.get rect() Bake eos a 
1367 io.pullUpDnControl(ballPins[player][pin],2) 1975 textRect.left - x agp q 
T37 198. textRect.top = y 
138. def showPicture(run,gal): pygame. draw. rect(screen, ( 
139. | screen.blit(background, [0,0]) 199. 102,204,255), (x, y, 14, th-10), 0) 
140. . screen.blit(horse1,[run[0],30«gal[0] ] ) 200. if f==0 : 
141. . screen.blit(horse3, [run[1],120+gal[1] ] ) textSurface = font.render(words, True, (0,0,0), (102,204,255)) 
142. . screen.blit(foreground, [0,200]) 201. else : 
143. pygame.draw.rect(screen, (102,204,255), (0,340,942,136), 0) 202. textSurface - font2.render( 
144. if not restart : words, True, (0,0,0), (102,204,255)) 
145. screen.blit(move[puzzle[0]], [50,345]) 203. screen.blit(textSurface, textRect) 
146. pygame.draw.circle(screen, (255,154,51), ( 204. 
targetGx[moveTarget[@] ]450, targetGy[moveTarget[@] ]+345) ,8,0) 205. def initGraphics(): 
147. screen.blit(move[puzzle[1]], [471450, 345]) 206. global background, foreground, horse1,horse3,move,moveState, 
148. pygame.draw.circle(screen, (255,154,51),( gameSound 
targetGx[moveTarget[1] ]+50+471, targetGy[moveTarget[1]]+345),8,@) 207. soundEffects = ["start","gallop","end", "ratchet", "horse1", 
149.  drawWords("1 - Raspberry Rake",120470,350,0) "horse2"] 
150. drawWords("3 - Not Quite Pi",1204471470,350,0) 208. background = pygame.image.load( 
151. | drawWords(str(winningPost-run[0])*" to go",120+70,400,1) "images/track.png").convert alpha() 
152. | drawWords(str(winningPost-run[1])*" to go",120+70+471,400,1) 209. foreground = pygame.image.load( 
153.  pygame.display.update() "images/rail.png").convert alpha() 
154. 210. horsel = pygame.image. load("images/rr.png").convert_alpha() 
155. def finish(distance): 211: horse3 = pygame.image.load("images/np.png").convert_alpha() 
156i if distance != 0: 2127 move = [ pygame.image.load( 
1577 caption = "Wins by " + margin(abs(distance)) "images/dir"+str(m)+".png").convert_alpha() for m in range(0,12) ] 
158. if distance < 0 : 213: moveState = [ [0,3], [3,9], [2,1], [5,2], [6,1], [1,9], [6,2], [2,3], 
159. x- 1204704471 [3,1], [1,3], [3,2], [2,0] ] 
160. else: 214. gameSound - [ pygame.mixer.Sound( 
1615 x= 120470 "sounds/"+soundEffects[sound]+".wav") for sound in range(0,6)] 
162. drawWords (caption,x,400,1) 215» 
163; else : 216. def terminate(): # close down the program 
164. drawWords("Dead heat",120470,400,1) 217. print "Closing down please wait" 
165. drawWords("Dead heat",1204704471,400,1) 218. pygame.mixer.quit() 
166. pygame.display.update() 219. pygame.quit() # close pygame 
167. 220. os. exit(1) 
168. 221 
169. def margin(dist): 222. def checkForEvent(): # see if we need to quit 
170. separation - dist / 120.0 223. global restart 
171. if separation >1.8: 224. event - pygame.event.poll() 
172 return "a distance" 225. if event.type -- pygame.QUIT : 
173. elif separation 50.9: 226. terminate() 
174. return "a length" 227. if event.type == pygame.KEYDOWN : 
1757 elif separation >0.7: 228. if event.key == pygame.K_ESCAPE : 
176. return "three quarters of a length" 2297 terminate() 
177. elif separation »0.4: 230. if event.key == pygame.K_RETURN : 


178. return "half a length" restart = True 

1797 elif separation >@.25: 

180. return "a neck" 233. # Main program logic: x 
181. elif separation »0.2: 

182. return "a short neck" 

183. elif separation »0.1: Ly 

184. return "a head" 


T85- elif separation »0.05: 
return "a short head" 


he, 


raspberrypi.org/magpi January 2017 MagPi | 55 


BOINC Manager 


File View Tools Activity Advanced Help 


Notices | O Projects | lll Tasks | 4 Transfers | li Statistics | © Disk 


Keep an eye on how much 
power your tasks are using 


Donate power to scientific 
projects using your 
Raspberry Pi 


Connected to localhost (7.4.23 


Got a Raspberry Pi that idles away most of its day? 
Lend some of its CPU power to science 


emember screen savers? It occurred to us the SETI, the organisation that looks for extraterrestrial 
BOINC other day that they've gone almost totally out life. With this screen saver, you'd also be lending some 
boinc. of fashion, with turning your screen off being of your computer power to help them out. 
berkeley.edu the preferred (and probably greener) solution to burn- The technology still exists with BOINC and is 
A Raspberry Pi in. One of the more popular screen savers of the time used in many more applications these days, such as 
darsma: was a little display that showed number crunching from protein folding and anything else that requires lots of 
An internet processing power. We recently had a reader write in 
connection about using the idling CPU power of a Pi with it, so we 


decided to put together a little tutorial to let people 
uve appe = share some Pi goodness with the science world. 


@ network usage © disk and memory usage | Jéexclusive applications 
>STEP-01 


Choosing a Pi 

* Not just any Raspberry Pi is suitable for running 

"| BOINC. If you're making projects and using your 
Pi as a normal computer, you're likely not going 
to have it idling often. The kind of Pi that works 
best for BOINC is something that's on all the time, 
or at least for a long time each day: file servers, 
home automation, Christmas tree lights, and so 
on. These have a lot of processing power to spare, 
more than enough to lend some to another project 
using BOINC. 

Remember, though: this does mean it will use up a 

| little more electricity while performing BOINC tasks, 

so keep that in mind. 


$25Z5bESN 


Right Change the 
settings to make atch Nd ec 


sure your Pi works 
as best as it can 
with BOINC 
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>STEP-02 

Installing BOINC 

BOINC is included as one of the packages available for 
Raspbian, so installing it is pretty easy. First, you need 
to perform the customary update to the Raspberry Pi 
by opening a Terminal and entering: 


sudo apt-get update 
sudo apt-get upgrade 


Once that’s complete, you can then install BOINC 
from the command line. Do this with: 


sudo apt-get install boinc 


This will install BOINC and the graphical BOINC 
Manager tool for easily accessing and controlling how 
you use BOINC. It even shows stats for your projects. 


>STEP-03 

Open BOINC 

BOINC works in both the command line and on the 

graphical desktop. It’s a bit more involved to get 

it working in the command line, but if that’s your 

preferred method, we suggest taking a look at this 

great tutorial on how to do so: magpi.cc/2hgkTYO. 
For this tutorial, we’re going to be working in the 

desktop environment. Go to the top-left menu in 

Raspbian; under System Tools you'll find the BOINC 

Manager. Open it up, and we can start choosing and 

adding projects to the system. 


>STEP-04 

Choose a project 

Choose ‘Add project’ on the screen and then go to 
Next. If you already have a BAM! or GridRepublic 
account, you can also add it here instead. You'll then 
be presented with a list of projects you can join, such 
as the aforementioned SETI. They'll usually give 
details on what they're studying and how you can help 
them, but you might need to do some extra online 
research as well. 


Above The advanced view gives you more options 
for keeping an eye on your projects 
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Tutorial 


Click your choice and then press Next. From here 
you need to create an account (or log in if you already 
have one), and the project will be ready to start. 


>STEP-05 

Configure BOINC 

The default settings for BOINC are fine, but you 
might want to do a bit of tweaking anyway, especially 
to change what it considers as idle on your system. 
From the View menu, select Advanced View to access 
all the options. Here you can change not only the 
processor usage, but also set limits on network and 
disk/memory usage. You can even drill down a bit 
further into what tasks BOINC is running, how many 
resources it’s using, and further stats. 


>STEP-06 

Run BOINC 

All you need to do now is leave your Raspberry Pi and 
BOINC running. It will automatically take tasks from 


the project you signed up to and do some crunching on 


them. It may take a little while longer on the Pi than 
some other computers, but you'll be doing your bit 
for science nonetheless. After reboots, you may need 
to double-check it's running, and it's best to check 
Pis that are on 24/7 every now and then to make sure 
they're doing the job properly as well. 


Above The installation on the command line is quick 
and pretty easy - you'll have it in no time 


Above Choose one 
or more of multiple 
projects that will 
help scientists 


ENERGY 
USAGE 


As mentioned, 
you'll use 

up more 
electricity 
using BOINC. 
Change the 
settings to 
tweak how 
much it uses. 


SENSITIVITY 


Worried your 
Pi will want to 
do something 
and not have 


the power? 
Tweak how it 
defines idle 
to make sure 


the Pi gets 
power when it 
needs it. 
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Tutorial WALKTHROUGH 


Strange critters 


roam the Earth on 
a chilly winter day 


Youll 
Need 


> Camera Module 
magpi.cc/ 
28ljlsz 


> PsyCam 
magpi.cc/ 
2eCSQOD 


RASPBERRY PI 2 
COMPATIBILITY 


m 
] 


, JOHANNES BERGS 


Johannes Bergs wants to know 
more and likes the realm of 
humans and machines. 
knight-of-pi.org 


Do computers dream of electric sheep? Find out by making your 
Raspberry Pi dream with the amazing Google DeepDream algorithm 


reams can be beautiful, surreal, or even 

scary. While we can assume that they playa 

role in learning, their exact purpose remains 
unknown. What would a computer see if it could 
dream? You can find out by installing the amazing 
Google DeepDream software on your Raspberry Pi! 

DeepDream is derived from a neural network 
for object recognition, which has been modified 
to express every object it vaguely recognises. The 
resulting images are impressively surrealistic, 
bearing more than a passing resemblance to the 
paintings of artists like Salvador Dalí. 

Neural networks are a very versatile technology. 
They can be applied to a variety of complex problems 
like facial recognition, text translation, or even 
playing games like Go. 

Caffe, the neural network upon which Google built 
DeepDream, was originally developed for identifying 
objects in images. To achieve this, the network is 
trained on a large set of images to identify the main 
features of the objects presented. 
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Artificial neurons 

Artificial neurons mimic their natural counterparts, 
the neurons in the human brain. Every artificial 
neuron has an activation threshold and numerous 
weighted incoming and outgoing connections to other 
neurons. If the sum of the weighted signals from 

the incoming connections exceeds the activation 
threshold, the neuron fires a signal. 


Neural networks 

Generally, neural networks consist of at least three 
layers of neurons. The input layer reads the input, one 
or more hidden layers process the information, and 
the output layer shows the result. 

Consider a neural network for recognising the 
numbers zero to nine in images with a size of 28x28 
pixels. The input layer would have 784 neurons, one 
for every pixel. If an image is presented to the input 
layer, every neuron in it produces a signal with a 
strength corresponding to the greyscale value of its 
pixel, with a darker pixel generating a stronger signal. 
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Every input neuron is connected to all neurons of 
the first hidden layer, but every connection has a 
distinct weight. The higher the weight, the more of 
the input neuron's signal reaches the hidden neuron. 
If the total signal strength arriving at a hidden neuron 
tops its activation threshold, the hidden neuron fires 
a signal to all neurons of the next layer which, in 
this simplified example, is the output layer. Again, 
the signal intensity depends on the weight of the 
connection and the incoming signal strength. 

The output layer has one neuron for every object to 
be classified, so ten neurons are used to identify the 
numbers from zero to nine. If the activation threshold 
of an output neuron is surpassed by the weighted 
incoming connections, the resulting signal strength is 
a measure of confidence in the classification. 


Machine learning 
The weights and thresholds are initialised randomly, 
which can cause very bad classification results. 

If an output neuron is activated incorrectly (e.g. 
if an image from the training set shows a five, but 
the output neuron for two produces a strong signal), 
its activation threshold and all the weights of its 
incoming connections are adjusted. Then, the error is 
propagated back proportionally through all connected 
neurons lower in the chain, from the highest hidden 
ayer down to the input layer. This process is repeated 
for all of the images in the training data set until the 
results given by the network begin to improve. 

Instead of accurately detecting objects in images, 
by contrast, DeepDream actually changes the input 
image to make it more similar to the objects learned 
from the training data. 

Imagine a cloud as an input image. Some structure 
in the cloud might have a vague similarity to the 
features DeepDream associates with a ‘dog-like’ 
object. If this is the case, the input image is changed 
to look more dog-like. 

Additionally, DeepDream allows for selection of the 
hidden layer depth. Since a layer has more detail the 
closer it is to the output level, output images can range 
from basic shapes to detailed dream-like creatures. 
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DEEPDREAMS 


Have some DeepDreams 

Insert an SD card with Raspbian Jessie installed into 
the Raspberry Pi, attach the Camera Module and 
peripherals, then boot it up. To install the DeepDream ijt RIP VIA 
software, enter the following in a Terminal: magpice/28C390D 


>PYTHON 


mkdir ~/deepdream && cd ~/deepdream 

git clone https://github.com/JoBergs/PsyCam 
cd PsyCam 

python install_tools.py packages 

python install_tools.py caffe 

python install_tools.py protobuf 

python install_tools.py camera 

sudo reboot 


ORIGINAL 
DEEPDREAM 
ARTICLE 


Have a look at 
the amazing 
original 
article about 
DeepDream 
by Alexander 
Mordvintsev, 
Christopher 
Olah, and Mike 
Tyka here: 
magpi.cc/ 
2eCRHH3 


After downloading the project from GitHub, use 
the custom installer to first install all packages with 
pip or apt-get. Then, install the open-source neural 
network framework Caffe. Because speed matters, you 
should also install the serial data processor protobuf 
from Google. Finally, activate the camera and reboot. 

Allin all, the installation takes a few hours, so 
you'll need to be patient! The installer should also 
work for any newish Ubuntu operating system. If you 
encounter problems, try using the manual installation 
instructions at magpi.cc/2eCSxDt. 

Enter the following, and your Pi can start to dream: 


NEURAL 
NETWORK 
TUTORIAL 


If you want to 
learn more 
about neural 
networks, 
why not 
check out this 
interesting and 
well-written 
introduction 
by Michael 
Nielsen?: 
magpi.cc/ 
2eCUO1u 


cd ~/deepdream/PsyCam 
python psycam.py 


The network parameters depth (-d), octave (-0), 
and type (-t) are randomized. Add a -c to dream 
continuously. Pass -i IMAGE. jpg to use an image 
as the base for the dream instead of a snapshot. Find 
more information on input arguments by checking the 
command-line help: 


KIVY GUI 


Try the 
powerful 
Python GUI 
framework 
Kivy for 
building a 
GUI: it is slick 
enough to 
embrace 
DeepDream. 


python psycam.py -help 


When the Pi finishes dreaming, the dream and the 
original photo are stored in the directory /home/pi/ 
deepdream/PsyCam/dreams with a timestamp. You 
can watch them by opening the directory in the file 
browser and double-clicking the image. 


| 
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i)) 


Raspberry Pi 
running Raspbian 


Sonic Pi v2.9* 


Speakers or 
headphones with 
a 3.5mm jack 


Update Sonic Pi: 
sudo apt-get 
update && sudo 
apt-get install 
sonic-pi 


sonic P 


SAMPLE 
STRETCHING 


Sam Aaron shows how to do more with samples 


hen people discover Sonic Pi, one of the 

first things they learn is how simple it is to 

play pre-recorded sounds using the sample 
function. For example, you can play an industrial 
drum loop, hear the sound of a choir, or even listen to 
a vinyl scratch, all via a single line of code. However, 
many people don't realise that you can actually vary 
the speed at which the sample is played back for some 
powerful effects and a whole new level of control of 
your recorded sounds. So, fire up a copy of Sonic Pi and 
let's get started stretching some samples! 


Slowing samples down 
To modify the playback rate of a sample, we need to 
use the rate: opt: 


sample :guit em9, rate: 1 


If we specify a rate: of 1, then the sample is played 
back at the normal rate. If we want to play it back at 
half speed, we simply use a rate: of 0.5: 


sample :guit em9, rate: 0.5 


Notice that this has two effects on the audio. Firstly, 
the sample sounds lower in pitch; secondly, it takes 
twice as long to play back (see the boxout on the next 
page for an explanation of why this is the case). We 
can even choose lower rates moving towards 6, soa 
rate: of 0.25 is a quarter speed, @.1 is a tenth of the 
speed, and so on. Try playing with some low rates and 
see if you can turn the sound into a low rumble. 


Speeding samples up 

In addition to making the sound longer and lower 
using a small rate, we can use higher rates to make 
the sound shorter and higher. Let's play with a drum 
loop this time. First, listen to how it sounds at the 
default rate of 1: 


sample :loop amen, rate: 1 
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Now, let's speed it up a little: 
sample :loop amen, rate: 1.5 


And we just moved musical genres from old-skool 
techno to jungle! Notice how the pitch of each drum 
hit is higher, as well as the whole rhythm speeding up. 
Now, try even higher rates and see how high and short 
you can make the drum loop. For example, if you use a 
rate of 100, the drum loop turns into a click! 


Reverse gear 
I'm sure many of you are thinking the same thing right 
now: “What if you use a negative number for the rate?”. 
Let's think about this for a moment. If our rate: opt 
signifies the speed at which the sample is played back, 
with 1 being normal speed, 2 being double speed, and 

0.5 being half speed, -1 must mean backwards! Let's try 
it on a snare. First, play it back at the normal rate: 


sample :elec filt snare, rate: 1 
Now, play it backwards: 
sample :elec filt snare, rate: -1 


Of course, you can play it backwards twice as fast 
with a rate of -2, or backwards at half speed with a 
rate of -0.5. Now, play around with different negative 
rates and have fun. It's particularly amusing with the 
:misc burp sample! 


Pitch bending 

As we've seen, using a faster rate will make the sound 
higher in pitch, and a slower rate will make the sound 
lower in pitch. A very simple and useful trick is to 
know that doubling the rate actually results in the 
pitch being an octave higher; inversely, halving the 
rate results in the pitch being an octave lower. This 
means that for melodic samples, playing it alongside 
itself at double/half rates actually sounds rather nice: 
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FIVE LIVE-CODING TECHNIQUES 


SAMPLE, RATE, AND PITCH 


One of the effects of rate modification on samples is that faster 
rates result in the sample sounding higher in pitch, and slower 
rates result in the sample sounding lower in pitch. Another place 
you may have heard this effect in everyday life is when you're 
cycling or driving past a beeping pedestrian crossing. As you're 
heading towards the sound source, the pitch is higher than when 
you're moving away from the sound: the so-called Doppler 
effect. Why is this? 

Let's consider a simple beep which is represented by a 
sine wave. If we use an oscilloscope to plot a beep, we'll see 
something like Figure A. If we plot a beep an octave higher, we'll 
see Figure B, and an octave lower will look like Figure C. Notice 
that the waves of higher notes are more compact, and the waves 
of lower notes are more spread out. 

A sample of a beep is nothing more than a lot of numbers 
(x and y coordinates) which, when plotted onto a graph, will 
redraw the original curves. See Figure D, where each circle 
represents a coordinate. To turn the coordinates back into 
audio, the computer works through each x value and sends the 
corresponding y value to the speakers. The trick here is that the 
rate at which the computer works through the x numbers doesn't 
have to be the same as the rate at which they were recorded. 
In other words, the space (representing an amount of time) 
between each circle can be stretched or compressed. So, if the 


computer walks through the x values faster than the original rate, 


it will have the effect of squashing the circles closer together, 
which will result in a higher-sounding beep. It will also make the 
beep shorter, as we will work through all the circles faster. This is 
shown in Figure E. 


sample :bass trance c, rate: 1 
sample :bass trance c, rate: 2 
sample :bass trance c, rate: 0.5 


Tutorial 


Finally, one last thing to know is that a mathematician called 
Fourier proved that any sound is actually lots and lots of sine waves 
all combined together. Therefore, when we compress and stretch 
any recorded sound, we're actually stretching and compressing 
many sine waves all at the same time in exactly this manner. 


Bringing it all together 
Let's look at a simple piece combining these ideas. 
Copy it into an empty Sonic Pi buffer, press Play, listen 


to it for a while, and then use it as a starting point for 


However, what if we just want to alter the rate so that 
the pitch goes up one semitone (one note up on a piano)? 
Sonic Pi makes this very easy via the rpitch: opt: 


your own piece. See how much fun it is to manipulate 
the playback rate of samples. As an added exercise, try 
recording your own sounds and play around with the 


rate to see what crazy sounds you can make. 


sample :bass trance c 
sample :bass trance c, rpitch: 3 
sample :bass trance c, rpitch: 7 


live loop :beats do 
sample :guit em9, rate: [0.25, 0.5, -1].choose, amp: 2 


sample :loop garzul, rate: [0.5, 1].choose 


If you take a look at the log on the right, you'll notice 
that an rpitch: of 3 actually corresponds to a rate end 
of 1.892 and a rpitch: of 7 corresponds to a rate 
of 1.4983. Finally, we can even combine rate: and 
rpitch: opts: 


sleep 8 


live loop :melody do 
oct = [-1, 1, 2].choose * 12 


with fx :reverb, amp: 2 do 


sample :ambi choir, rate: 0.25, rpitch: 3 

sleep 3 

sample :ambi choir, rate: 0.25, rpitch: 5 

sleep 2 

sample :ambi choir, rate: 0.25, rpitch: 6 

sleep 1 

sample :ambi choir, rate: 0.25, rpitch: 1 end 
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16.times do 


n = (scale 0, :minor pentatonic).choose 
sample :bass voxy hit c, rpitch: n + 4 + oct 
sleep 0.125 


end 
end 
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Tutorial STEP BY STEP 


PISPY CAM 


Set up a motion-activated spy camera in your room to find out 
if anyone's coming in when you're not there 


Pi Zero 


PIR motion 
sensor 
magpi.cc/ 


2gCQKPj 


Raspberry Pi 
Camera Module 
magpi.cc/28ljlsz 


Pi Zero camera 
cable adapter 
magpi.cc/ 
2gT2KwE 


Portable battery 


e've all been there. You've gone out for the day 

and you know you closed your bedroom door, 

but you come back and it's slightly ajar. Who's 
been in there? Were they friend or foe? 


>STEP-01 

Connect up the camera 

Attaching the camera to the Raspberry Pi Zero is easy, 
and if you read our camera beginner's guide you'll 
already have an idea. You'll need to first switch out the 
cable in the Camera Module with the adapter for the 

Pi Zero. Gently pull down on the clasp that keeps the 
ribbon on the Camera Module attached and remove 
the cable. Take note of the orientation of the silver 


A very simple Fritzing diagram 
just to make sure you know 
how to wire up the sensor 
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connectors on the cable you removed, and make sure 
your adapter cable is the same way round when you 
insert it. Put the other, smaller side into your Pi Zero, 
with the silver connectors facing towards the board. 


>STEP-02 

Wire up the circuit 

The circuit for this is fairly simple, especially as the 
PIR doesn’t need a resistor as part of its setup. The PIR 
comes with three connections: VCC, GND, and OUT. 
VCC needs to be connected to a5V power pin, GND 
needs to go to a ground pin, and then there’s the OUT 
wire which will be our input. We’re connecting it to 
pin 8, also known as GPIO 14. 

If your Pi Zero has GPIO pins attached, you can do 
this via a breadboard; otherwise you can loop the wire 
around the pin holes and use a bit of Blu-Tack to keep 
them in place, or a dab of glue from a glue gun ona 
low setting. Soldering is also an option. 


>STEP-03 

Get the code 

Write up or download our code for this project. This 
code uses two libraries: GPIO Zero and the standard 
picamera library. GPIO Zero can be used to get a 
reading from the PIR motion sensor very easily, which 
can then be tied into the picamera code so it takes a 
photo when motion is detected. We make sure the 
photo is given the time so you know when it was 
taken, and it then waits five seconds before seeing if 
it should take another photo. Save it as spy.py in the 
default home folder. 


>STEP-04 

Final preparations 

You can run it first to give ita test. You might want to 
change the sensitivity, which you can do by adjusting 
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Tutorial 


You should probably hide yours 
somewhere slightly better - its 
range is far, though 


Camouflaged against Yoshi, 
the camera will take candid 
snaps of anyone who comes 
close to your game collection 
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the little orange screws on the side of the PIR board. 

Once that's done, it's best to make it so that when the Jpy.py 
Raspberry Pi boots up, it logs directly into command- 

line mode. This means it will use up a little less power #!/usr/bin/env python 
so your battery lasts longer. It’s then a good idea to 


DOWNLOAD: 
magpi.cc/PiSpy 
open up the terminal and edit the profile config file gpiozero MotionSensor 


with sudo nano /etc/profile. To the bottom of the 


picamera PiCamera 
file, add this line: datetime datetime 
time sleep 


sudo python spy.py 


sensor - MotionSensor(14) 


Now you need to camera = PiCamera() 


find a good place to PE 
. filename = datetime.now().strftime("%H.%M.%S_%Y -2óm- 76 ) 
hide your camera camera. capture(filename) 


sleep(5) 


Hide your camera 

Now you need to find a good place to hide your 
camera. The cable for the camera is limited by length, 
while the PIR can have its wires lengthened, so keep 
that in mind when building your system. Hiding the 
Pi and battery behind a plush toy or photo frame can 
work well; you could even put a dummy photo up and 
cut a hole in it for the camera to look through. The PIR 


has quite a wide range, so put it up high where people 
are unlikely to look. 


Check for intruders 

All you need to do now is plug in the battery and the Pi 
Zero will turn on and run the script. Do some tests to 
make sure the camera is facing the right way. Leave it 
running during the day and then when you get back, 
plug it into a monitor, stop the script, and run startx 
to get the GUI up. From here you can see the pictures 


it has taken - crucial evidence to catch your dog or 
sibling red-handed. 


raspberrypi.org/magpi January 2017 MägPi | 63 


Tutorial STEP BY STEP 


There are some 
great fantasy 
sprites included in 
Scratch, including 
this purple 
hedgehog-like 
creature! 


Move the 
trampoline left 
and right to catch 
the hedgehog and 
bounce it back up 
in the air. 


when clicked 


BOUNCY E 
HEDGEHOG em 


when left arrow | key pressed 
Spike the hedgehog loves playing on the change x by 
trampoline, but he’s a bit clumsy. Can you move 
the trampoline to stop him landing with a bump? 


set size to [20] 96 


when right arrow | key pressed 


Q ho doesn't love hedgehogs? Here we are change x by 


going to make a simple Scratch game with an 
additional dose of prickly goodness, in which 


you use the cursor keys to move the trampoline left project, we have chosen to use the atom- playground 

and right to catch a bouncing hedgehog target. This image from the Outdoors folder. 

tutorial shows you how to bring in new sprites and 

backgrounds, and how to use the bracket blocks and >STEP-02 .02| 

diamond blocks in your projects. You'll find these Adding player 

skills useful as you build other things in the future. controls when clicked 

Start a new Scratch project, and get ready to bounce! Click on the set size to €f) % 
trampoline (which 

>STEP-01 should be Sprite1) point in direction 

Prepare your artwork in the Sprite List to 

For this Scratch project, you don't need the cat sprite, select it, and then walt secs 

so right-click it in the Sprite List and then choose click the Scripts tab 

Delete. To add a new sprite, click the icon above the above the Blocks 

Sprite List that shows a folder and a star. Add the Palette. Listing 1 shows the scripts you need to add to 

trampoline sprite from the Things folder, then the this sprite. Work your way down them, dragging the 


fantasy11 sprite from the Fantasy folder. Let's change blocks into the Scripts Area one at a time and joining 
the background too: click the Stage in the Sprite List them up. Click the white holes in the blocks and type 
and you will see that the Costumes tab changes to the right numbers in. Remember that the colours 

a Backgrounds tab. Click the tab and use the Import are a clue: to find the yellow blocks, click the yellow 
button to bring in your choice of background. For this Control button above the Blocks Palette first. 
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BOUNCY HEDGEHOG 


Tutorial 


clicked 


when 


set size to [ 40] 96 


point in direction 


go to x: | -200| y: 


wait £y secs 


repeat until y position < 


>STEP-03 

Set up the hedgehog 

Click Sprite2 (the hedgehog) in the Sprite List. Add 
the script shown in Listing 2 to it. This puts the sprite 
at the top left of the Stage when the game begins, and 
gives the player a chance to spot it before it moves. 


when clicked 

set size to £T) % 
point in direction 
go to x: -200| y: 150] 


wait secs 


y position < 


repeat until 


move [6| steps 
> 


if on edge, bounce 


>STEP-04 

Add a repeat loop 

We're now going to extend that script by adding some 
more blocks at the bottom of it. Listing 3 shows the 
entire script, including the bits you've already done. 
Click the Control button above the Blocks Palette. Drag 
arepeat until block into the Scripts Area and join it 
to your script so far. (Make sure you don't use the repeat 
block with a number in it). Next, you need to drop a « 


Hew sprite: yy "Y ?X 


show 
export this sprite 


duplicate 


Above Right-click the sprite in the Sprite List to delete it (note 
that the buttons to add a sprite are found above the cat) 
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block into the diamond-shaped 
hole. Click the Operators button 
above the Blocks Palette to find it. 
Type -120 into the box on the right. 
Finally, click the Motion button and 
dragthey position block into 

the left box. Now, whatever we put 
inside the repeat untilbracket 
will be repeated until the sprite's 

y position (how far up or down the 
screen it is) is less than -120. In our 
game, that means it has missed the 
trampoline and hit the floor. 


>STEP-05 

Make the hedgehog move 

To make the sprite move, add the two Motion blocks 
shown in Listing 4 into the repeat until block in 
your script. Click the green flag above the Stage to 
test it so far. You should see the hedgehog go to the 
top left of the Stage, plummet down, and stop when 
it reaches the bottom. 


when clicked 

set size to £T) % 
point in direction f E32 
go to x: [ -200 | y: [150] 
wait £l secs 


y position « -120| 


move @ steps 
LI 


repeat until 


if on edge, bounce 
b 


if touching Sprite 


point in direction pick random fT to 45] 


>STEP-06 

Make the trampoline bouncy 

We need to make the hedgehog bounce back up again if 
it touches the trampoline. Click the Control button and 
drag an if block into your script. Be careful with where 
you put it: it belongs inside your repeat until bracket, 
as shown in Listing 5. Click the Sensing button and drag 
in a touching block for the diamond-shaped hole in 
your if block. Click the menu in the touching block to 
choose Sprite1 (the trampoline). Inside the bracket of 
your if block, adda point in direction 90 Motion 
block. Instead of putting a number in its hole, this time 
we'll use a pick random block with values of -45 and 
45. You'll find it in the Operators section of the Blocks 
Palette. Now the sprite will point in a random upward 
direction (between 45 degrees left and 45 degrees right) 
if it touches the trampoline. Finally, add a say block 

at the end of your script, outside all the brackets. This 
message is shown when the game ends. 


pick random f to £T) 


Above 

The Operators 
blocks include the 
block for picking 
random numbers, 
and the blocks 

for comparing 
numbers 


SCRATCH 
ESSENTIALS 


Learn more 
about Scratch 
in our book 
Learn to Code 
with Scratch, 
which takes 
you from 
beginner to 
pro. Find out 
more here: 
magpi.cc/ 
Scratch-book 


Magri 
LEARN TO 
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FREQUENTLY 
ASKED QUESTIONS 


Your technical hardware and software problems solved... 


56 


FAQ. 


Right You don't 
have to just 
boot from an SD 
card any more 


YOUR QUESTIONS ANSWERED 


BOOT 


DEVICES 
rare Ho 


SD card 

A micro SD card is the main boot option for the 
Raspberry Pi, and the easiest to use. Images can be 
burnt to the card or loaded via NOOBS. You can then 
use the card for storage if it’s big enough, or make use 
of external storage options. 


USB 

The space on SD cards is a little more limited than 
what you can get on USB storage, flash or otherwise; 
so depending on how much data you’re using, it might 
be a good idea to create a USB-booting Raspberry Pi. 


Ethernet 

The Raspberry Pi 3 added the ability for the Pi to be 
booted over the network. This allows you to set up a 
boot option for a Pi and then just plug Pis in as you see 
fit. It’s great for businesses and enterprise solutions. 
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NEED A 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


ia 


Enable USB boot 

You'll need to boot normally via the SD card first 
to enable USB booting. You'll need to edit the way 
Raspbian boots, so that you can then make the 
change to the Raspberry Pi itself before attempting 
to boot from USB. 


Prepare USB storage 

The USB storage needs to have Raspbian copied 
directly to it from the SD card. You'll need to do some 
partitioning magic on it to get it working properly, 
and it will probably work a bit better if you have 
access to a Linux machine. 


Full instructions 

The steps to create the USB-booting Raspberry Pi 
and appropriate USB media are a bit long for these 
pages, but you can read up on the full procedure on 
the Raspberry Pi website here: magpi.cc/2gaEyYt. 


Debug boot mode 

The initial preparation procedure is similar to booting 
over USB, albeit with a twist to make sure it tries to 
boot from the Ethernet port instead. You can start to 
capture data from the Ethernet after the change. 


Configuration 
A few files and options need to be changed for 

it to all work; this includes the DHCP request and 
reply, along with TFTP. It's not massively complex, 
but you need to make sure you're doing it right for 
it to work. 


Full instructions 

Ethernet booting is a lot more complex than USB 
booting, but there's great info on it on the Raspberry 
Pi website that can help you to get it working: 
magpi.cc/2gTnVyR. You can also check out The MagPi 
#50 for a full guide on both. 
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Where is the on/off switch on the Raspberry Pi? 

There is no on/off switch! To switch on, just plug it in. To 
switch off, if you're in the graphical environment, first exit 

to the Bash prompt or open the Terminal. From the Bash 
prompt or Terminal, you can shut down the Raspberry Pi by 
entering the command, sudo halt -h. Wait until all the 
LEDs except the power LED are off, then wait an additional 
second to make sure the SD card can finish its wear levelling 
tasks and write actions. You can now safely unplug the 
Raspberry Pi. Failure to properly shut down the Raspberry 
Pi may corrupt your SD card, which would mean you would 
have to re-image it. 


What is NOOBS? 

NOOBS stands for New Out Of Box Software, and it's our 
recommended installation method. It allows you to install 
the distro of your choice, even if you have little to no 
computing or Linux experience. 


YOUR QUESTIONS ANSWERED 


When will the next model of the Raspberry Pi 

be released? 

As of February 2016, the third generation of the Model B 
Raspberry Pi has been released. Beyond this revision, 
which upgraded the main processor on the board 

to a 64-bit version, there are no immediate plans to 
release any more new models. We concentrate our 
engineering effort on making the software that runs on 
the Raspberry Pi faster and better all the time, which is 
why you should always ensure that you are running the 
most recent firmware. 


What are the dimensions of the Raspberry Pi? 

The Raspberry Pi measures 85.60 x 56 x 22mm (or 
roughly 3.37 x 2.21 x 0.83 inches), with a little overlap 
forthe SD card and connectors which project over 
the edges. It weighs 45g. The Pi Zero measures 

65 x 30 x 5.4mm (or roughly 2.56 x 1.18 x 0.20 inches). 


WD PIDRIVE 
FOUNDATION 
EDITION FOR 
RASPBERRY PI 


Offering USB functionality and an SD card 
, the WD PiDrive Foundation Edition 
is your ideal storage solution for Raspberry Pi. Start creating 


projects in a matter of moments. 


© wDLABS 


wdlabs.wd.com/products 
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£12.99 


200 pages of 


RASPBERRY PI 


PROJECIS BOOK 


VOLUME 2 


Amazing hacking and making projects 


from the creators of MagPi magazine 


Inside: 
How to get started with Raspberry Pi 
The most inspirational community projects 
Essential tutorials, guides, and ideas 


Expert reviews and buying advice 


Available 
mE magpi.cc/MagPiStore 


plus all good newsagents and: 


WHSmith BARNES&NOBLE 


4  Availab e on the GET IT ON 
« App Store P» Google Play 
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feature ROKON >- 


RUN 
PIXEL 


ON YOUR COMPUTER 


The PIXEL desktop is now available for Intel 
computers: use this month's free DVD or burn a USB 
drive and get the best desktop interface on your laptop 


he Raspberry Pi is by far our 
favourite computer. So we 
were delighted to discover 


that the Raspberry Pi Foundation 
was making a version of Debian with 
PIXEL for Intel machines. 

With this month's physical version 
of The MagPi, you'll find a free 
DVD. Load this up on your laptop or 
desktop and you'll find it's just like 
using a Raspberry Pi. 

If you don't have a Debian 
with PIXEL DVD, don't worry. 
The Raspberry Pi Foundation has 
made Debian with PIXEL available 
as a downloadable ISO file. 

You can use the ISO file to create 
your own Debian with PIXEL DVD, 
or to build yourself a bootable USB 
drive to run the PIXEL desktop 
on your computer. 

In this feature, we'll show you how We'll show you how to create a USB 


n se acomputer into! Debian drive of Debian with PIXEL for your 
with PIXEL and what you can do with 


the OS on your home computer. We'll 
also look at saving files and creating 
a USB drive that you can use to boot 
into PIXEL on any computer. 


USB DRIVE 


computer. The USB drive is faster 
than the DVD, and you can save 
your work directly to it. 
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RUN PIXEL ON YOUR COMPUTER. Bi/[74177777 


THE PIXEL DESKTOP ze XxX 


The PIXEL desktop runs on your 
computer just like on a Raspberry 
Pi. It sits on top of Debian, the 
same Linux OS that is compiled for 
ARM to create Raspbian. 


DVD DRIVE = lel 2s 


Load Debian with PIXEL using the 
DVD-ROM. It runs straight from 
the DVD and won't interfere with 
your primary operating system. 
Remove the DVD and restart your 
computer when 

you've finished. 

You'll restart 

in your regular 

operating 

system. 
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WITH YOUR FREE DVD 


Load up the PIXEL desktop on any computer with a 
DVD-ROM drive and use it just as you would on a Raspberry Pi 


ebian with PIXEL is designed to be as easy to 


use as possible. So it's no surprise that running 
the DVD on your computer (whether it is a Mac, 
Linux, or Windows machine) is straightforward and 
simple. It's just like using Raspbian on a Raspberry Pi. 
Boot a computer with the DVD inserted into the 
drive and it'll load into Debian with PIXEL instead of 
its regular OS. It's as simple as that! 
With the DVD inserted, you can work on your 
computer just as you would on a Raspberry Pi. 


Welcome tO DI XE 


— 


mes lenovo 


Debian with 
PIXEL DVD 
Mac or PC 
DVD drive 
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Start up 

Turn on your computer and insert the DVD into 

the drive. Needless to say, you'll have to be using a 
computer with a DVD drive. If your computer hasn't 
got one, then you'll need to create a bootable USB 
flash drive to run Debian with PIXEL - see page 76. 

If you are using PC-based hardware, it doesn't 
matter if you typically boot into Linux or Windows. 
Most PC computers are set up to boot from the DVD 
drive before the hard drive. You should hear the DVD 
spin and see ‘Welcome to PIXEL powered by Debian’ 
instead of your usual operating system. 

If you're booting from an Apple Mac computer, then 
you can either hold down the C key on your keyboard 
when you hear the Apple ‘bong’ noise, or hold down 
ALT and choose the DVD as the startup disk. 


The boot process 

After a short while you'll see a screen displaying 
‘Debian (Jessie) with PIXEL i386’. You will also see 
‘Press Esc for options’ and a timer counting down. 


BOOT MENU = El XxX 
A Pressing ESC while booting into 
Debian with PIXEL brings up the 
‘OP Boot menu options. Here you'll see 
two options: ‘Run Debian’ and ‘Run 


Debian without Persistence’. 

If you don't press ESC, it will 
automatically pick the first option. Persistence is 
something we'll Look at a lot in this feature. It enables 
you to save changes to the OS while working from the 
DVD or a bootable USB drive. 

Picking Debian without Persistence may help you 
boot into Debian, although you won't be able to save 
any files or changes you make to the OS. 

Press TAB to view the command-line boot for the 
option you have selected. Here you can add and 
remove specific options. Adding nomodeset after 
686-pae can help some older Macs boot. 

When you're happy with the boot option, press 
ENTER to boot the DVD. 


Debian (jessie) with PIXEL 
i386 


Build: 2016-11-17 
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RUN PIXEL ON YOUR COMPUTER 


PC BIOS = H X 


A We found Debian with PIXEL to 
be reliable on our test PCs. If it 
‘OP doesn't start, you probably need 

to adjust your BIOS (Basic Input/ 

Output System) settings. Press Fa 

on your keyboard (or follow the on- 
screen instructions) after starting up, to access the BIOS 
settings. These are the default hardware options for 
your computer (the settings that don't depend on the 
operating system). Use the arrow keys to move around 
and look for Startup and Boot. On our ThinkPad, it is 
called Boot Priority Order. Use the * and - keys to move 
the DVD drive to the first position. Choose Save and 
Exit, then Yes to reboot and try again. 


Don't press anything. When the counter hits zero, 
you'll see ‘Loading, please wait’. 

You need to be patient when loading from a DVD. It 
may take a long time to start, depending on the speed 
of your DVD drive. Be patient. 


Logging in 

During the boot process, you will see the ‘raspberrypi 
login’ appear on the boot screen. Don’t enter any text; 
you will be logged in automatically and taken to the 


PIXEL desktop interface. The default username is pi, 
and the password is raspberry. 


Using Debian with PIXEL 


You can now use Debian with PIXEL on your computer 
just as you would on a Raspberry Pi. Be aware that any 
files you create aren’t saved when you finish. Choose 
Menu > Shutdown > Shutdown when you’ve finished, 
to switch off the operating system. 
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You can work on your 
computer Just as you 
would on a Raspberry Pi 
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feature ROKON >- 


USING IHE DVD 


Start using Debian with PIXEL on your computer 


PACKED WITH PROGRAMS x 


m 


The team has curated the best 
office and coding software 
around. This software makes 
Debian with PIXEL an ideal 
creative and learning system. 


THE PIXEL DESKTOP INTERFACE 


ë ODE Eion Teach- 


hen Debian with PIXEL has loaded, you can 
use your computer just as you would use a 
physical Raspberry Pi. 

Start by clicking the Menu icon in the top-left to 
access all the built-in software. Here you'll find the 
finest collection of programming tools and educational 
resources around. Debian with PIXEL also comes with 
LibreOffice, a strong alternative to Microsoft Office. 

The programming tools are where it really shines. 
Programs like Greenfoot Java, Scratch, and Sonic Pi are 
all available. It even has the Sense HAT Emulator and 
links to all of the Raspberry Pi help and resources. 


DOWNLOADS 


MORE FROM THE BLOG. 


Get online 

One of the first things you'll want to do is connect 
Debian with PIXEL to the internet. Click on the 
Network icon in the menu bar to view local wireless 
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Raspberry Pi - Teach, Leam, and Mak 


Suse qu 


NETWORK x 


You can connect the OS toa 
local wireless network and 


use the built-in Chromium 
web browser (with Flash) to 
access online resources. 


e with Raspberry Pi - C 


COMMUNITY 


PIONEERS 


7 / 


PIONEERS: 
#MAKEYOURIDEAS 


PIXEL DESKTOP x 


The PIXEL desktop on your 
regular computer looks and 
works much as it does ona 
Raspberry Pi. This makes it 


ideal for Learning to code. 


[T 


networks. Choose a network and enter the password 
(the ‘Pre-Shared Key’). Alternatively, if your laptop 
has an Ethernet socket, you can use an Ethernet cable 
to connect directly to a network or your home router. 

Once you are online, it's possible to browse the 
internet using the built-in Chrome browser with 
Flash support. You can also download software to 
Debian using APT. 
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Programs you install using APT are stored 
in memory and can be utilised until you shut 
the computer down. 

When you turn off Debian, all the files you have 
created (and the programs you have installed) are 
wiped from the system. This refresh can be useful. 

Without a persistence drive, Debian with PIXEL starts 
up as a fresh install each time, making it handy as a 
teaching tool. Be careful not to lose any files, though. 


Persistence drive 
If you want to be able to save files, and keep programs 
you've installed, you'll need a persistence drive. 

The persistence drive works in tandem with your 
DVD. The DVD disc is used to boot the computer, and 
files you save into your home folder are stored on the 
USB drive, but everything works as a single volume. 

Creating a persistence drive is pretty simple. You 
format a USB drive in a Linux format (typically ext4) 
and give it the label persistence. 

After formatting the drive, you need to create a 
configuration file on the root of the drive. The file 
is called persistence.conf and contains the text: 

/ union. This configuration file tells the USB 
partition to work in union with the DVD. 


Format the drive 

The easiest way to format a hard drive is to use an app 
called GParted. Open a Terminal window and enter sudo 
apt install gparted. When this is finished, enter 
sudo gparted to run the program with sudo privileges. 

Click the Disks menu in the top-right of GParted (it 
should say /dev/sda) to view your hard drives. There will 
be one option for each drive on your computer. 

Now attach your USB drive and choose GParted > 
Refresh Devices (or press CTRL+R). Click the Disks 
menu again and you'll see the new option. 

Typically it'll have the smallest amount of space 
(measured in GiB). Be careful to select the USB drive 
and not your primary hard drive. 


PERSISTENCE DRIVE Oo x 


6 OON 


Install GParted to format a USB drive and create a 
persistence drive. This drive is used to save files and 
changes you make to the Debian OS. 
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RUN PIXEL ON YOUR COMPUTER 


THE STORY BEHIND DEBIAN WITH PIXEL 


We caught up with Eben Upton, 
co-founder of the Raspberry Pi 
and CEO of Raspberry Pi Trading, 
to discuss the creation of Debian 
with PIXEL for Intel machines. 

"| guess the real questions is 
"why didn't we do it earlier?'," 
Eben tells us. "People used 
to say to us things like: 'why 
aren't you doing software?' and 
“everyone's got a PC" 

The answer back then was: 
'everyone doesn't have a PC' 
and 'people are scared to break 
them, so they don't want to get 
their hands dirty’. 

So the Raspberry Pi Foundation 
concentrated its efforts on making 
hardware for a long time and the 
software for the Raspberry Pi was 
generic for a large part of that 
time. "Then Simon [Long] joined 
us,” says Eben. 

Simon has done an enormous 
amount of work to transform 
the stock Raspbian desktop 
into the much more polished 
PIXEL experience. 

One thing that's superb is 
“the curation,” explains Eben. 


feature 


N 


Software like Flash, Chromium, 
Java, and LibreOffice requires a 
lot of effort to get on board. "It's 
getting close to being the perfect 
environment for productivity and 
learning to code. 

“We've now got a piece of 
software that's pretty interesting. 
The question became: ‘why are we 
forcing people to buy a Raspberry 
Pi to run it?' 

"So we've come full circle," 
Eben concludes. "We're giving it a 
go to see if people like it." 


First, right-click the long horizontal bar and choose 


Unmount (if it is available). Next, right-click on each 
partition in the list and choose Delete until you see a 
grey horizontal bar with ‘unallocated’. 

Choose Partition » New. Enter persistence in the 
Label field and click OK. 

Finally, click the green tick icon (Apply AII 
Operations) and click Apply in the alert window. 


Configure the drive 
Now we need to add a persistence.conf file to the root of 
our formatted disk. Remove and reinsert the USB drive. 

Enter cd /media/pi/ and sudo chown pi 
persistence to change ownership of the drive. 

Next, enter cd persistence/ to move to the root 
of the USB drive, and then sudo echo / union » 
persistence.conf. 

The echo command writes ‘/ union’ to a file called 
persistence.conf on the root of your hard drive. You 
can check it using cat persistence.conf. 

Now all you need to do is restart your computer. 
Enter sudo reboot. The computer will boot from the 
DVD drive, and use the persistence USB drive. 
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MAKE A 


DEBIAN 


WIH H PIXEL 
USB DRIVE 


What if you haven’t got a DVD drive? 
SEES Don't worry: you can create a bootable USB drive... 


» USB drive L 
» Debian any newer computers don't come with Getting the ISO 
with PIXEL Q DVD-ROM drives. So what happens if you You'll need the Debian with PIXEL ISO file. You can 
ISO file want to run Debian with PIXEL on your turn the DVD-ROM into an ISO file using a program 
computer, but you don't have a drive? called InfraRecorder in Windows (magpi.cc/2fP6wZT), 
The answer is pretty simple: create a bootable USB Disk Utility in Mac OS X, or by using the dd command 
flash drive from the Debian with PIXEL ISO file. in Linux. However, it's better to download the latest 
Most modern computers can boot directly from version of the ISO from the Raspberry Pi Foundation's 
a USB drive. This drive is faster and slightly more website (magpi.cc/21MYYTMo). 
reliable than using a DVD (and older laptops can have í 
flaky DVD-ROM drives). Using Etcher 


You can partition a USB drive to contain both Debian There are many ways to turn the ISO file into a 
with PIXEL and the persistence drive. It’s like having bootable drive. We find it easiest to use the Etcher tool 


a Raspberry Pi in your pocket that you can boot on (etcher.io). We looked at Etcher in-depth in issue 50 
virtually any other computer. of The MagPi (magpi.cc/Back-issues). 
Sounds fun? Let’s make one! We generally use Etcher to create SD cards to boot 
up our Raspberry Pi, but it turns out to be just as 
FIX A MISSING MENU BAR E E] x handy for burning bootable USB drives. 
Open Etcher and click Select Image. Choose the ISO 
Occasionally we found the PIXEL file containing the Debian operating system. Now 
menu bar didn't appear. In this insert your USB drive. It may appear automatically 
case press CTRL*ALT*Fa to switch under Select Drive (otherwise click Select Drive and 
to another session (enter pi and choose the correct disk). Click Flash! to copy the 
raspberry to log in). Now enter ISO file to the USB drive. Enter your password, if it's 
sudo pkill lxsession to requested, and click OK. 
restart the LXDE environment. You'll be taken back í 
to the PIXEL interface with a login screen. Starti ng up 


Now restart your computer with the USB drive 
attached. If you have been using the DVD, don't 
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RUN ON YOUR COMPUTER 


Q Etcher 


SELECT IMAGE 


SSS 


live-image-i...6.hybrid.iso 


E eui 


forget to remove it from the drive first, or you'll boot 
from that instead of the USB drive. 

Many PCs are set up to boot from a USB drive 
before the primary hard disk, but if yours is not, you 
may need to access the BIOS settings and change 
the boot order (press F1 or follow the on-screen 
instructions during startup). 


If you installed Debian with PIXEL using an ISO file 
you created from the DVD, you will need to turn the 
remaining space on the USB drive into a persistence 
partition. You won't need to do this if you installed 
Debian with PIXEL using an ISO downloaded from the 
Raspberry Pi Foundation website (it includes a script 
that automatically creates the persistence partition). 
Open a Terminal window and enter sudo apt 
install gparted. When it's finished, enter sudo 
gparted to run the program with sudo privileges. 


If you're struggling to get the 

USB drive to start up on a Mac, 

try formatting the drive into 

two partitions. The first partition 

should be FAT32 and 1.5GB in 

size with a boot labeL The rest 
of the drive should be a Linux ext4 partition with 
the label persistence. You then use 7z to unzip the 
contents of the ISO into the FAT32 partition. We 
found these instructions on CosmoLinux helpful: 
magpi.cc/2ggdzrs 
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Q Need Help? $* 


SELECT DRIVE 


resin.io 


Y Use 
Etcher to 
record the 
ISO file into 
a bootable 
Debian USB 
drive for your 
computer 


-eft With your 
USB drive, 
you can boot 
directly into 
Debian with 


Click on the Disks menu and choose the USB drive 


PIXEL: it's just 
from your disks. It should be the smallest drive. like usinga 
: : : Raspberry Pi 
Right-click on the grey horizontal bar marked computer 


‘unallocated’ and choose New. 

Enter persistence in the Label field and click Add. 
Click the green Apply icon and click Apply in the Apply 
Operations to Device alert window. Click Close when 
you see ‘All operations successfully completed.’ 

Restart with sudo reboot. This will mount both the 
boot volume and the persistence volume. 

Open a Terminal window and enter cd /media/pi. 
Here you will see the mounted persistence partition 
(enter 1s -1 to view the volume and its permissions). 
You need to take ownership of it to make changes. 
Enter sudo chown pi persistence to take change 
the ownership of the drive from root to pi. Enter 
ls -1 to view the permissions again. 

Use cd persistence/ to move to the root of the 
drive. Enter echo / union > persistence. conf 
to create the persistence configuration file. Use cat 
persistence. conf to check the contents of the 
configuration file. It should be just ‘/ union’. 

Enter sudo reboot one last time. You will now 
boot into Debian with PIXEL from your USB drive. 
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Maker 
says 
It's easy 

to build and 

lots of fun 


to use 
Mime Industries 


ARCBOTICS 
SPARKI 


The Sparki 
comes with 
sensors missing 
from the 
Mirobot and 

an on-board 
display, but it's 
considerably 
more expensive 
asaresult. 


E 
£145/$149 


arcbotics.com 


" 
P 


MIROBOT V2 


PROGRAMMABLE ROBOT 


Platform-agnostic and tool-free, could the Mirobot be the perfect 
first robot for budding makers? 


hen a Mirobot drops 

through the letter box, it 

comes as a real surprise. 
Whereas most robots come in bulky 
packaging, the Mirobot sits ina 
simple cardboard box the size of a 
few stacked CDs. It’s easy to assume 
that it’s small as a result, but it’s 
actually testament to creator Ben 
Pirt’s talents: the packaging for the 
Mirobot becomes the robot itself. 

The Mirobot’s body is constructed 
from laser-cut wood, and the kit 
takes the form of sheets of wood 
with the pieces still in place. Holes 
are cut out for the non-wood 
components, like the motors and 
circuitry, and the whole lot carefully 
assembled and held together with 
two elastic bands at the corners. 
The result: very little goes to 

waste. The outer framework from 
each slab of wooden components is 
useless once popped out, but can be 
disposed of as compost or used as 
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fuel in a fire, while everything else 
bar the cardboard outer gets put to 
use, even the elastic bands. 

The build process is tool-free and 
simple: someone with no experience 
of electronics can easily follow the 
instructions, printed in colour with 
illustrative photographs, and end up 
with a working Mirobot in around 
10 or 20 minutes. The only slightly 
tricky steps are inserting the non- 
keyed wires into the main circuit 
board, which must go ina specific 
way around, and calibrating the pen 
using the included tool, laser-cut 
from wood, as with everything else 
in the kit. 


Ease of use 

Once built, the Mirobot is powered 
by four AA batteries and operates 
entirely independently. Initially, 
the on-board wireless hardware, 
which uses the low-cost ESP8266 
WiFi module, broadcasts as an 


unencrypted hotspot to which you 
can connect a smartphone, tablet, 
Raspberry Pi, or laptop in order to 
configure the device. 

Here's the second surprise: 
there's no software to install. 
Everything on the Mirobot, 
from upgrading its firmware to 
programming it, takes place in 
your web browser. You can choose 
to use it offline in unencrypted or 
encrypted hotspot mode, or give 
it your WiFi details to connect it to 
your home or school network. 

If you choose the latter, you 
gain access to the Mirobot Apps 
from the official website. These 
offer a wide range of choices for 
programming the robot: a spartan 
drag-and-drop block-based user 
interface which is available locally; 
the Blockly, Snap!, and Scratch 
block-based languages, though the 
latter is Adobe Flash-based and 
unavailable from a Raspberry Pi; 
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Right The full 
kit comes with 
a chassis to put 
your robot on 


Python or JavaScript text-based 
languages, complete with in- 
browser development environment 
and syntax highlighting; and a 
point-and-click interface for easy 
drawing. There's also a direct 
remote control option, which 
allows you to control the Mirobot 
using on-screen buttons; coupled 
with a smartphone, this turns the 
Mirobot into an admittedly slow 
remote-controlled car. These are 
all available for offline use, too, 
through a Chrome app which can be 
installed into Google's web browser 
on all supported operating systems. 
In use, the Mirobot acts like 
your average turtle robot. It can 
raise or lower the pen, which you 
must provide yourself, to draw 
shapes on paper, turn in either 
direction, move forwards and 
backwards, and emit a beeping 
noise from its on-board speaker. 
The updated kit, now in version 2.0, 
also includes an optional infrared 
sensor, which when installed can 
be used to turn the Mirobot into 
a line-following robot. 


More to learn 

The manual does, however, stop just 
short of where an absolute beginner 
might have liked. In particular, 
you'll find no reference to fitting 

the line-follower in the printed 
documentation, the need to calibrate 
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MIROBOT V2 PRO 


the pen's position and height, and 
calibrating the distance the robot 
travels by drawing and measuring a 
line, in order to produce clear shapes 
from your programs. 

Fortunately, the official website 
includes a learning resource section 
with easy-to-follow guides for 
all these tasks. Cleverly, they're 
also capable of connecting to any 
Mirobot on your local network: the 
page for calibrating the motors, 
for example, allows you to press 
a button to draw a line, then type 
in the length once measured, the 
result of which is sent back to the 
robot and stored in its permanent 
memory automatically. You'll also 
find guides to drawing shapes, using 
the line-follower, and technical 
documentation on the Mirobot's 
communications protocol. 


{ast word 


It's impossible to dislike the 
Mirobot. From its simple tool- 
free build process and clever 
packaging to its browser- 


based user interface, the 
machine is a joy from the 
moment it arrives and a sure- 
fire hit with younger makers. 


GRAMMABLE ROBOT 


1- Fonction dron polypon sides. 
A » Js : 


Chrome App Javascript 


SS lum a - H 
—— Iro P 
r 
z 
Mirobot UI Point & Click 
QIIO 


QE 
IRR ERG 


Scratch 


Remote Control Snap! a 


Above Program your robot from a web browser for maximum ease 
Below It comes with WiFi built into the board so you can access it 
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Maker 
says 


Makes 
the creation 
of one-off 
projects and 
prototypes 
as simple 


as possible 
MonkMakes 


ADAFRUIT 
PERMA- 
PROTO 


Available in 
three sizes, this 
PCB prototyping 
board matches 
the design 

of aclassic 
breadboard, 
without the 
extra connectors 
you find on the 
MonkMakes 
ProtoBoard. 


£10 / $13 
magpi.cc/2fPNZwh 
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NÈ x 


PROTOBOARD 


A PCB breadboard-style prototyping board with extra features 


ike many electronics 

hobbyists, Simon Monk 

likes to prototype projects 
on a solderless breadboard before 
transferring them to something 
more permanent once everything 
is tested and working correctly. He 
says he's never been completely 
satisfied with other prototyping 
board designs, though, so he decided 
to address what he saw as their 
shortcomings. The result is the 
MonkMakes ProtoBoard. Following a 
successful Kickstarter campaign, it's 
now available as a deluxe kit from 
Amazon (amzn.eu/3YhwMak). 

Inspired by Adafruit's Perma- 
Proto boards, the ProtoBoard 
mirrors the layout of a standard 
solderless 400- point breadboard, 
featuring the usual interconnected 
rails and rows, but adding longer 
rows at the bottom of the board 
for modules that use 2x4 or 2x5 
pins, such as the ESPo1 or NRF24 
modules: a nice touch. 
The most obvious difference, 

however, is the addition of an area 


on the right-hand side where you 
can put extra components that 
don't fit straight onto a breadboard. 
These include a standard ‘sugar 
cube’ relay, 3.5mm audio jack, and 
general-purpose screw terminals. 
There’s also an area at the top for 
creating a power supply by adding 
a barrel jack and linear voltage 
regulator and capacitors. This can 
be connected to one or more power 
rails by soldering the +V and GND 
bridges on the board. 

Two packs of components are 
supplied in the deluxe kit available 
from Amazon, along with a half- 
size solderless breadboard and four 
rubber feet. When prototyping 
projects, Simon advises sticking 
the breadboard permanently to 
one of the ProtoBoards and adding 
a full set of components to the 
side panel. Then, once your circuit 
is working as intended with this 
setup, it should be very easy to 
transfer (or copy) breadboard 
components to another ProtoBoard 
placed to the side, as well as 


replicating any components used 
in the side area. It's a neat idea 
that really does help. 

As well as being suitable for any 
project that you could start with a 
400-point solderless breadboard, 
the ProtoBoard can be used for those 
that feature a microcontroller such 
as a Particle Photon or Arduino Pro 
Mini - you could even use it to make 
an off-board Arduino. 


{ast word 


With a well-thought-out 
design, the ProtoBoard 
makes it easier to transfer 
projects from a solderless 
breadboard to a more 
permanent PCB, featuring 


through-plated connection 
holes. In particular, the side 
panel comes in very handy 
for components that don't fit 
straight onto a breadboard. 
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MOTE HOST 


The original 
Mote controller 
plugs into the 
USB port of 

any computer, 
including Pi 3, Pi 
2, or B+. Like the 
pHAT, it features 
four micro USB 
outputs. 


£11/ $14 
magpi.cc/2g9iyLs 
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A more compact way to control Mote light strips 


eaturing 16 super-bright 

RGB LEDs, Pimoroni's 

Mote ‘stick’ light strips 
(£8.50 each) are ideal for under- 
shelf/cabinet mood lighting, among 
other applications, and can be 
used to create some impressive 
effects. Until now, a Mote Host 
has been required to control 
the sticks, plugging into any 
computer - including the Pi - 
via USB. For a far more compact 
and convenient setup, the Mote 
pHAT does the same job. Its pHAT 
form-factor matches that of the 
Pi Zero perfectly, so you can tuck 
it discreetly away out of sight. You 
will need to solder the female 
GPIO header onto the Mote pHAT 
first, although at least this does 
give you the option of usinga 
stacking header to use it alongside 
other add-on boards: you could 
get Mote sticks to display sensor 
readings from an Enviro pHAT, 
for example, or control them with 
buttons or switches. 


(D 


As with the Mote Host, there 
are four output channels via 
micro USB ports for controlling up 
to four Mote sticks independently 
of each other. A Python library 
(magpi.cc/2fwA0oFX) is provided, 
along with a few examples to get 
you started. These include an 
impressive rainbow effect, colour 
cycling, and CheerLights web 
control via Twitter. The library 
itself is easy to use, enabling you 
to set each individual RGB pixel on 
each of the four channels. They are 
triggered with a show command, 
and clear is used to turn them off. 
Using a for loop, we soon managed 
to create a simple chase lights 
effect — handily, if you exceed the 
highest pixel number, it wraps 
round to the start of the strip 
again. Since the LEDs are APA102 
standard (aka DotStar) with a 
fast data rate, there are none of 
the timing issues you might get 
with NeoPixels and they respond 
almost instantaneously. 


Run our 
beautiful 
Mote lights 
straight from 
your Pi or 


Pi Zero 
Pimoroni 


You can even control them 
from your phone or from a web 
browser by setting up a Flask API. 
Pimoroni's step-by-step tutorial 
(magpi.cc/2g9g143) shows how to 
use HomekKit to control the lights 
from an iPhone, using Siri voice 
commands to turn them on and off 
and to set the colour - a good way 
to impress friends! The same result 
should be possible using Google 
Assistant or Alexa, too. 


Jast word 


The Mote sticks are excellent, 
even better than NeoPixels, 
and the new Mote pHAT offers 
a compact, discreet way of 
controlling them without the 


need to connect to the USB 
port of a laptop or Pi. At just 

£5 it's great value, although of 
course you'll still need to buy 
sticks (and cables) to use with it. 
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Just 
enough 0S 


for Kodi 
LibreELEC 


OSMC 


OSMC 
dispenses with 
the standard 
Kodi interface 
to use its own 
take. This makes 
it flow slightly 
differently while 
still having a 
strong base. 


Settings 


System 
Network 
Connections 
Services 
Bluetooth 


About 


System Name 


Keyboard Layout 
Keyboard Layout Variant #1 
Keyboard Layout 
Keyboard Layout Variant #2 


Keyboard Type 


ipdates 


* LibreELEC 


Just enough OS for KODI 


Automatic Updates 


14:40 


Tuesday, 12 July 2016 


LibreELEC 


pc105 


manual 


Configure a hostname, keyboard type, perform a reset, update, or backups and restores 


LIBREELEC 


A new media centre OS for the Raspberry Pi with familiar ancestry, 
is LibreELEC an upgrade over OpenELEC? 


t's been a while since 

we've looked at a new 

media centre for the 
Raspberry Pi. The ‘market’, for lack 
of a better term, has been wrapped 
up for a little while now by OSMC 
and OpenELEC, so it's not like 
there's been much call for another 
one. Both are great and offer 
something slightly different over 
the other, so unless you're going 
to reinvent the wheel, there's not 
much more to add. 

Which brings us to LibreELEC. 

It doesn't reinvent the wheel, but 
what it does is out-OpenELEC 
OpenELEC; it's probably the 
slimmest and most lightweight 
Kodi (née XBMC) OS you'll find. 
This comes as no surprise when 
you learn of LibreELEC’s lineage 
as an offshoot of OpenELEC 
itself. If you know your open- 
source software, it’s a little bit 
like OpenOffice and LibreOffice, 
albeit with no corporate 
buyouts involved. 
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LibreELEC aims to carry on the 
more open, free spirit of earlier 
OpenELEC releases, while still 
staying at the bleeding edge of 
Kodi's release schedule. There's 
also a commitment to stability, 
which is very welcome. You can 
see their cutting-edge credentials 
on the website; as Kodi ramps up 
to release version 17, each beta 
release is closely followed by a 
pre-release of the next LibreELEC. 

For this review, we're 
concentrating on their stable 
release at the time of writing, 
LibreELEC 7.0. Installation is a 
doddle and it's handled by software 
developed for all major platforms 
(including a generic Linux one!). 
This software allows you download 
an image (stable by default, but 
you can select the beta), choose a 
destination for the image, and then 
burn it. It's easy to use and very 
fast as well, although the speed is 
probably down to how small the 
image itself is. Usually something 


like Raspbian can take up to ten 
minutes to burn to an SD card, 
whereas LibreELEC was done in a 
minute. There's even a progress bar 
to keep track of it. OpenELEC had a 
similar piece of software, but it was 
never quite as developed as this. 


Media consumption 
First boot is easy and familiar, 
too. The SD card is resized to 
fill the space, and a couple of 
other minor tasks are performed 
before it reboots into the media 
centre. The reboot countdown 
timer takes longer than the initial 
operations on a Raspberry Pi 3, 
and the true first boot itself is over 
pretty quickly. 
From here things start to look a 
lot more familiar. LibreELEC comes 
with the default version of Kodi, 
rather than a reskinned one like 
OSMC. You're asked some basic 
details, and then it immediately 
allows you to connect to WiFi using 
the Raspberry Pi 3's on-board 


raspberrypi.org/magpi 


wireless. It also has a pretty good 
range of codecs for WiFi dongles 

if you're using a Pi 2. With that 

set, you're done and ready to 

start adding media sources. This 
was one of the nice things about 
OpenELEC: it was fast and simple, 
offering the Kodi environment a lot 
of people are already familiar with. 


The way LibreELEC 1s built 


work absolutely fine on the Pi 2 
and Pi 3. Particularly in the case 
of OpenELEC, unless you're 
experiencing issues it's not really 
worth the hassle of reinstalling 
and getting all your media set 

up again. While LibreELEC does 
also support first-generation 
Raspberry Pis (and the Pi Zero), 


seems just that little bit more 
optimised for the Raspberry Pi 


Using it feels just a little bit 
faster and smoother as well. Since 
the Pi 2 release, Kodi hasn't had 
any issues on the Pi, but the way 

ibreELEC is built seems just that 
ittle bit more optimised for the 
Raspberry Pi. The UI flows well, 
media playback works absolutely 
fine, and it didn’t break at all 
during testing. There's no sacrifice 
in terms of functionality or ease of 
use, either. 

It's not exactly a game-changer, 
though. OpenELEC and OSMC 
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you're still limited a bit by the 
CPU on those lower-powered 
models, so again there's not much 


of a difference in the performance. 


Kodi 17 is just on the horizon, 
though. The software releases 
fairly regularly as it is, but this 
could make for a shift in the way 
the Pi media centres perform in 
the near future. With LibreELEC 
working closely with Kodi, much 
like OpenELEC does, we're very 
interested to see how this next 
generation of OSes will perform. 


Left Welcome to 
Kodi, powered by 
LibreELEC 


© select version 


Raspberry Pi 2 and 3 v | LbreELEC-RPI2.arm-7.90.009.img.gz, 122 MB 


eQ Download or select a local image file 


Qownload Select fie 


Select your USB stick or SD card 


G:\ [7.4 GB] 


[4] Write mage 


Above The 
installation tool 
is quick and easy 
to use 


{ast word 


If you like your Kodi default, 
clean, and lightning fast, 
LibreELEC is the OS for you. 


May not be worth the hassle 
of an upgrade if your current 
HTPC Pi is working fine, though. 
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RASPBERRY PI 
BESTSELLERS 


The latest Rails can do anything; 
probably even make your coffee! 


LEARNING RAILS 5: 
RAILS FROM 
THE OUTSIDE IN 


Author: J Mark Locklear 
Publisher: O'Reilly 
Price: £31.99 

ISBN: 978-1491926192 


ind 
magpi.cc/2gFZC78 Leal ping 


Rails ; 


Avery good intro book, but 
errors in code mean you'll also 
learn from debugging as you 
go along. Sample projects build 
very logically through learning 
how to ‘do’ Rails. 


RUBY ON RAILS 
TUTORIAL 


Author: Michael Hartl 
Publisher: Addison Wesley 
Price: £40.69 

ISBN: 978-0134598628 
railstutoriaLorg 


Hartl's comprehensive 

boot camp of a book (and 
online read) is highly praised 

by those who suit his immersive 
teaching methods. An excellent 
grounding, well updated for 
Rails 5 features. 


AGILE WEB 
DEVELOPMENT 
WITH RAILS 5 


Author: Sam Ruby 

Publisher: Pragmatic 
Bookshelf 

Price: £32.99 

ISBN: 978-1680501711 

magpi.cc/2gG1mNr 


A beginner's guide into which 
agile, Ajax, REST, testing, 

and many best practices are 
closely woven into both its 
warp and its weft. Clear and 
thoughtful updates for Rails 5. 
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FREE TOMAKE 


Authors: Dale Dougherty 

& Ariane Conrad 
Publisher: North Atlantic Books 
Price: £17.50 
ISBN: 978-1623170745 
magpi.cc/2gFUrnw 


"^. Free to J 
RH Make 


15 Occ 
Lee 
f $ tf 


they are doing. The ‘where’ takes 
us on a tour of makerspaces, 
fab labs, and less formal 

ær Workshops. The ‘how’ 
explains the boards, tools, 
technologies, and whole 
maker ecosystem. The 
chapter on ‘The Maker 


«fe 


| 
P Uu" Mindset’ is an essential 
Few revolutionary e ‘o T examination of what 
é m 
changes inthe past à S PU vovonenry drives us to create - from 
da AMINE CONRAD 


have been as well 

chronicled as the still 

nascent maker movement, but if 

anyone is well-placed to give that 

commentary, it's Make: magazine 

and Maker Faire founder Dale 

Dougherty. As well as the who, 

what, and where of the movement, 

Dougherty gives us a philosophical 

background to this “global 

countercultural phenomenon”, 

which empowers people to move 

away from passive consumerism. 
This exploration starts off 

with a look at the diverse range 

of makers - and their projects 

- spurred on by a love of what 


UNDERSTANDING 
ECMASCRIPT 6 


Author: Nicholas C Zakus 
Publisher: No Starch 
Price: £24.99 

ISBN: 978-1593277574 
magpi.cc/2gFYgsZ 


ECMAScript 6 is a 
huge set of changes to 
avaScript - everything from 
Promises, to improve asynchronous 
programming, to several 
improvements to the good old array. 
What's needed to get the average — 

or even occasional - JS coder up to 
speed is a guide to put these changes 
in context, and to show what they can 
do. Enter Zakas, creator of ESLint, 
and a very experienced JS developer. 
Starting with Block Bindings, 

one of ECMAScript 6's solutions 

to previous versions’ problematic 
variable declarations, the author 
demonstrates admirable clarity 

in his explanations of how and 

why things work, followed by best 


UNDERSTANDING 
ECMASCRIPT 6 


playfulness, to a need to 
understand more fully. 

The closing chapters on makers’ 
impact on the world, and a look at 
future development, provide food 
for thought. The notes, chronology, 
and bibliography are also of benefit. 
This fascinating book should, as 
Tim O’Reilly puts it in the foreword, 
help you to “find your own inner 
maker. And start to measure 
yourself by what you make, 
not what you own or buy.” 


Score 


practice examples. So in the chapter 
on Iterators and Generators, Zakas 
gives you the historic background, 
then changes from 5 to 

6, how to implement, 

and only then - 


— 6’s built-in Iterators. 
Classes are a big feature 
in 6, and get appropriate 
treatment - including their 
first class citizenship (you 
can pass them into functions 
as arguments). ECMAScript 6’s 
tail call optimisation, changes to 
defining Object String Tags, user- 
definable non-enumerable and 
non-writable object properties: it's 
all here. Rounds off with a guide 
to ECMAScript 7 - or ECMAScript 
2016 - first of the new, yearly 
release cycle, containing only 
minor changes. Very readable. 
Recommended to any JavaScript 
user looking to grok ES6. 


Score 
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THE HITCHHIKER'S with a look at the programmer's 


GUIDE TO PYTHON 


Authors: Kenneth Reitz 

& Tanya Schlusser 
Publisher: O'Reilly 
Price: £17.99 
ISBN: 978-1491933176 
magpi.cc/2gFXdsS 


“Python is big. Really 
big” — yes, there are 
plenty of Hitchhiker's Guide to the 
Galaxy references here, a change 
at least from the obligatory Monty 
Python quotes in other Python 
works. Whimsy aside, this is a 
useful guide to immersing yourself 
in all things Pythonic, taking the 
confident beginner or intermediate 
programmer on a journey 
through the Python programmer's 
ecosystem, everything from good 
code writing, to reading and learning 
form other programmers. 

The long chapter on *reading 
great code" is particularly useful 
for those looking to step up from 
beginner status, but we start 


C++ IN 24 HOURS 


Menon Retz A Taye Sie 


environment, from Python version 
and implementation, through 
virtualenv and its alternatives, 
to the ever expanding choice 
of text editors and IDEs - 
where some may disagree with 
the authors’ preference for 
proprietary choices. 

The final section, covering 
libraries, features several 
chapters, with coverage 
of those for user interaction, 
code management, interfaces, 
data manipulation, and data 
persistence. Along the way this 
takes in everything from Jupyter 
Notebooks, through Continuous 
Integration, to the little known (but 
passionately advocated) Pyramid 
web framework. For anyone lacking 
a coding mentor, and/or a group 
of experienced Python using co- 
workers, this is a very special sort of 
‘missing manual’. Recommended. 


Score 


learning subjects into hour-long 
lessons to give time for digestion 


SAMS TEACH YOURSELF between sessions (you won’t 
| ~~~ profit from trying to 
Authors: Rogers Cadenhead | PN work through the book 
& Jesse Liberty UR À 
Publisher: SAMS p" in one caffeine-fuelled 
Price: £21.99 24-hour session!). The 


ISBN: 978-0672337468 | 
magpi.cc/2gFZFzH | 


eeta omon 


C++ is full of danger for 
the unwary, as it doesn’t 
provide the protections of higher- 
level languages like Java and Python, 
allowing you to shoot yourself in 
the foot, or even remove your leg. 
Nevertheless, much development 
on the range of interesting and 
low-cost boards available to makers 
needs C or C++ (or a subset thereof), 
and newbies still find themselves 
wanting to learn C++ to tackle 
embedded projects. It also remains 
fairly essential in gaming engines 
and other tasks where performance 
is critical. 

SAMY’ popular *... in 24 hours’ 
series break down complex 
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C++ 


success of the format is 

dependent upon every 
lesson building steadily 
at a good pace, and in 
good order. 

No intro book can teach you 
everything about the sprawling 
C++ language. The authors make 
some sensible choices, and this is 
a good step up the first few rungs 
of a precarious ladder. However, 
some updates for new language 
features such lambda expressions 
don’t feel well integrated into 
the text. On balance, a good 
introduction, but you'll need more 
resources to get further. 


Score 


BOOKS 


ESSENTIAL READING: 
NEW YEAR RESOLUTIONS 


Take the challenge: it's time once again to 
resolve to learn something new. 


Resolution: Functional programming 


Functional Programming in JavaScript 
Author: Luis Atencio 
Publisher: Manning 
Price: £36.62 

ISBN: 978-1617292828 
magpi.cc/2gFPDPb 


Learn the benefits of the functional = 
programming paradigm using a practical language 
that you know and love, and an authoritative guide. 


Seven Mobile Apps in Seven Weeks 


Author: Tony Hillerson 
Publisher: Pragmatic 
Price: £28.50 

ISBN: 978-1680501483 
magpi.cc/2gFYyjz 


Get to grips with building mobile apps for 
all devices with Pragmatic's excellent and 
practical ‘Seven Weeks... series. 


Resolution: Learn to play Go! 


Go / Wei Qi / Baduk 


Author: British Go Association 
Publisher: Many online resources 
Price: Free - download GNUGo 
ISBN: N/A 

magpi.cc/2gFZ290 


Learn the 5,500-year-old strategy game 
that's taxed the finest Al researchers’ 
minds. Play online or join a club. 


Resolution: Debug some software! 


Effective Debugging 
Author: Diomidis Spinellis 
Publisher: Addison Wesley 
Price: £24.99 

ISBN: 978-0134394794 
magpi.cc/2gFVUdF 


Bugs are everywhere; learn the advanced 
methods, strategies, techniques, tools, and 
tactics to squash even the most persistent. 


Resolution: Learn to think logically! 


Logic as a Tool 


Author: Valentin Goranko 
Publisher: Wiley 

Price: £45.00 

ISBN: N/A 
magpi.cc/2h8d8kB 


Classical logic is hard but rewarding - 
helping with clarity in programming, business 
decisions, and whatever life throws at you. 
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THE MONTH IN 


Everything else that happened this month in the world of Raspberry Pi 


y the time you read 

this, you'll probably TY 

be doing last-minute 
preparations for the big day. 
Don't forget to brine that 
turkey! You may also already 
have a load of Christmas 
decorations up, but there have 
been a few extra ones we've 


seen over Uhe pest monthichat We think this is very cute - a circuit 


you might want to consider = board built to look like a 3D Christmas 
if you’ re a truly massive Raspberry Pi's Alex Bate designed these 3D-printable decorations for tree, with LEDs and resistors you can add 
the Raspberry Pi and Code Club fan in all of us. They're quick to print to it. You then pop it on the GPIO pins and 


Raspberry Pi fan. and all you need to do is add some string to hang it up on the tree! program it to do whatever you want. 


This glowing festive house kit is wonderful - use a bit of Bare à SX This should look familiar - it's our cover from last issue! It 
Conductive's electric paint and your own creativity to make this was created by Lenard Gunda (twitter.com/Lenardg) by 
lovely decoration. It doesn't use a Pi, but it's great nonetheless! p following our tutorial. Did you also make our cover light up? 
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THIS MONTH IN PI PQQ 


CROWDFUND THIS! 


The best crowdfunding hits this month for you to check out... 


ARDUINO/ 
RASPBERRY PI 
1/0 CARD 


GRASPI 


A prototyping board that connects to any 


kek.st/2fWNasz | microcontroller or microcomputer with an [?C 


interface - which the Raspberry Pi has! It’s a very 


Sonic Pi is great, but so are guitars. GRasPi is a very well-thought-out piece of kit which greatly extends 
interesting concept, taking a portable, battery- the FC of the Raspberry Pi, with loads of connectors 
powered 15W guitar amplifier and making it work with and a 16-bit processor on board. It's already been 

a Raspberry Pi. This way, you can add effects and tie funded at the time of writing, so if you want to jump 


them to a pedal. It all runs on open-source software as on board and give this board a go, now's the time! 
well, which is pretty great. The campaign is asking for 
a decent amount of money, though (these things aren't 


aM DESIT OF THE REST 


—3-.:75 THWOMP 
a a CASE 


SRACK 


The pitch for this campaign is that conventional racks 
are large and inconvenient, so why not create a more 
DIY approach with something a little smaller that you 
can use at home if you want? Also, it’s built around the 
size of a Raspberry Pi. As the name suggests, you can 
easily store nine Raspberry Pis on the rack when built, 
and its simple design means you get pretty good access 
to all sides of the Raspberry Pi. 


CHICKEN 
POTE 


Chicken: 
Bouillon 
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"Post-Its 

I drew for our 
#LetsRobot 
subscribers. We 
put these in the 
physical sets made 
for the robots. | still 
have a lot more 

to draw...” 

Let's 

Robot aims to 
change the way 
we interact with 
television, putting 
the viewer in the 
driving seat 


The mother of adventure-ready robots, 
Pokémon catchers, and helmets 


et's Robot streams twice 

a week, Tuesdays and 

Thursdays, and allows 
the general public to control 
a team of robots within an 
interactive set, often consisting 
of mazes, clues, challenges, and 
even the occasional foe. Users 
work together via the Twitch.tv 
platform, sending instructions 
to the robots in order to navigate 
their terrain and complete the set 
objectives. Aylobot, the first robot 
of the project, boasts a LEGO body, 
while Ninabot, the somewhat 2.0 
upgrade of the two, has a gripper, 
allowing more interaction from 
users. Both robots have their own 
cameras that stream to Twitch, so 
that those in control can see what 
they're up to on a more personal 


level; several new editions have 
joined the robot team since then, 
each with their own unique skill. 

Let's Robot is the brainchild 
of Jillian Ogle, who originally 
set out to make "the world's 
first interactive live show using 
telepresence robots collaboratively 
controlled by the audience". 
However, Jill discovered quite 
quickly that the robots needed to 
complete the project simply didn't 
exist to the standard required... 
and so Let's Robot was born. 

After researching various 
components for the task, Jill 
decided upon the Raspberry Pi, 
and it's this small SBC that now 
exists within the bodies of Aylobot, 
Ninabot, and the rest of the Let's 
Robot family. 


-Eia f^ més Kelon NR 
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In her previous life, Jill worked 
in art and game design, including 
arole as art director for Playdom, 
a subsidiary of Disney Interactive; 
she moved on to found Aylo Games 
in 2013 and Let's Robot in 2015. The 
hardware side of the builds has been 
somewhat of a recently discovered 
skill, with Jill admitting, “Anything 
I know about hardware I’ve picked 
up in the last two years while 
developing this project.” 

More recently, as Let’s Robot 
continues to grow, Jill can be found 


The interactive sets take upa 
large part of the space at The Batchery, 
a ‘Global Startup Incubator’ in Oakland, 
California. 


Robot, originally a robot arm that 
would simulate the throw of an 
on-screen Poké Ball. It later grew 
wheels and took to the outside 
world, hunting down its pocket 
monster prey. It’s also worth 
noting other builds, such as the 
WiFi Livestream Goggles that Jill 
can be seen sporting across several 
social media posts. The goggles, 
with a Pi camera fitted between 


After researching various 
components for the task, Jill 
decided upon the Raspberry Pi 


sharing the antics of the robots 
across social media, documenting 
their quests such as the hilarious 
attempt to create party invites 
and the more recent Hillarybot vs 
Trumpbot balloon-head battle, 
where robots with extendable pin- 
mounted arms fight to pop each 
other's head. 

Alongside the robots, Jill has 
created several other projects 
that both add to the interactive 
experience of Let's Robot and 
comment on other elements of 
social trends out in the world. Most 
notably, there is the Pokémon Go 
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the wearer's eyes, allow viewers 
to witness Jill’s work from her 
perspective. It's a great build, 
especially given how open the 
Let's Robot team are about their 
continued work and progression. 
And finally, one project we 
are eager to see completed is 
the ‘in production’ Pi-powered 
transparent HUD. By incorporating 
refractive acrylic, Jill aims to 
create a see-through display that 
allows her to read user comments 
via the Twitch live-stream chat, 
without having to turn her eyes to 
a separate monitor. 
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EVENTS 


Community 


EVENT CALENDAR 


Find out what community-organised, Raspberry Pi- 


themed events are happening near you... 


RASPBERRY JAM 
SILICON VALLEY 


Want a Raspberry Jam in your 
area? Want to start one? 
Email Ben Nuttall about it: 


ben@raspberrypi.org 


MANCHESTER 

RASPBERRY JAM 

When: Saturday 14 January 

Where: The Shed, Manchester, UK 
magpi.cc/2£W9ag8 

Learn how to get started with the 
Raspberry Pi before attending 
workshops to learn more. 


MALVERN RASPBERRY PI 

JAM 

When: Wednesday 18 January 

Where: Wyche Innovation Centre, 
Malvern, UK 

magpi.cc/2fWb40e 

Show off your Raspberry 

Pi projects or just come to 

learn more about the Pi. 
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HONDURAS 


RASPBERRY JAM 
HONDURAS 

When: Friday 20 January 

Where: San Pedro Sula, Honduras 
magpi.cc/2fWkLf5 

An event for students to share 
knowledge of programming and 
electronics, and learn new things. 


RASPBERRY JAM 

SILICON VALLEY 

When: Saturday 21 January 

Where: Computer History Museum, 
Mountain View, CA, USA 

magpi.cc/2fW5KKg 

Find out about the Raspberry Pi 

and see other microcomputers 

at the Silicon Valley Jam. 


S 3) RASPBERRY JAM 
HIGHLIGHTED EVENTS REGULAR EVENTS 


PI CLUB 

When: Wednesday 4 January 

Where: Fab lab inventors, 
Munich, Germany 

magpi.cc/2fW312q 

The last of a series of regular 

Jams that have been held every 

Wednesday and Friday. 


TORBAY TECH JAM 
When: Saturday 14 January 
Where: Paignton Library and 
Information Centre, 
Paignton, UK 
torbaytechjam.org.uk 
This fun, family-friendly event aims 
to inspire people of all ages to get into 
coding and take up STEM subjects. 
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(J TORBAY TECH JAM 


HULL RASPBERRY JAM 
When: Saturday 21 January 
Where: Malet Lambert School, 
Hull, UK 
magpi.cc/2fW2Epy 
Get hands-on with digital making 
activities through workshops and 
a hackspace area. 


13TH EGHAM 

RASPBERRY JAM 

When: Sunday 22 December 

Where: Gartner UK HQ, 
Staines-upon-Thames, UK 

magpi.cc/2fW3CSJ 

Post-Christmas, people will have 

new Raspberry Pis and components 

for making exciting projects. 
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Community 


JAMS 
EVERYWHERE! 


SOUTH WEST NEEDS RASPBERRY JAMS 


While there are plenty of 
Raspberry Jams in the South 
East and Midlands, it's a bit 
harder to track down Jams in the 
farthest reaches of the South 
West of England. The regular 
Torbay Tech Jam is excellent, but 
it would be great to have a few 
more Jams going on! Find out 
more info on setting up Jams 
from previous issues and by 
heading to raspberrypi.org/jam. 
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LETTERS 


Download all the code 

Is there any way you could provide a ZIP file of all the code in each 
issue on your website when it’s released? This would make it a lot 
easier to obtain the code when you want to use it or copy it. 
Leonard Sparrow 


Right now we like to make sure all the code listings for the tutorials 
in the magazine exist somewhere online, usually via GitHub, so in the 
short term and for previous issues it might be best to follow those 
inks to get the code and such. 

However, that is a pretty good idea. We have been thinking 
about putting all the code up on GitHub for each issue, and 
providing it all as an extra ZIP file on our GitHub or directly from 
our website shouldn’t be too much of an issue. Take a look on the 
page for this issue on our website and we’ll trial putting all the 
code into a ZIP file for everyone. 


— 
= 


More to do with C 


With the release of the special issue Learn to Code with C, I was quite 
happy. I am learning how to program in C with the intention of 
using it with microcontrollers and eventually Java with Android. 

What I was hoping to see in your release was some information on 
RPi GPIO with C. I did a little searching and found that there could 
easily have been one whole special issue on this topic. Here’s hoping 
to see that in the near future. 

One thing that I noticed is that there are some differences 
with the way that the Raspberry Pi reacts to printf formatting for 
pointers. Using the same program as found in the Pointers chapter, 
on Ubuntu MATE, gcc provides a warning, requires long integer 
formatting to gives the correct values, and actually needs pointer 
formatting to provide no compiler warnings at all. I gather the 
Raspberry Pi is set up in a way that is unique in some aspects. 

I realise that the onus is on the programmer to find all this stuff 
out, but it might be worth a mention somewhere along the way. 
The other thing I was hoping to find out is that C is as easy to use as 
Python with the Raspberry Pi. I have seen the WiringPi site, as well 
as a tutorial on SparkFun. 
Bruce Fleming 


We're glad you like the C Essentials book: it seems like it has interested 
a lot of people and got them coding. We're definitely not done with C 
either and getting it working with the Pi's GPIO is definitely something 
we'll be considering in the future, so keep your eyes peeled. 

As for differences between systems, this is a tricky one as there's 
not much you can do about it. There can even be subtle differences 
between IDEs. We're sure all the code works as expected on Raspbian, 
though, as that's the main OS for all our Raspberry Pi stuff. 

Finally, Python is generally considered rather more straightforward 
to learn than C, which is why a lot of Pi stuff uses it! 


If you ever want to find out more info on Jams, 
there are great links on the Events pages 
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FROM THE FORUM: Ah, yes: unfortunately the delay in getting around the 


world can make some of the more extremely time- 
sensitive topics a bit harder to get right. In the UK the 
mag did come out only the weekend before Halloween. 
Luckily, as you may have noticed from last issue, the 
Christmas content came out in plenty of time for the 


holid 
whic 


The Raspberry Pi Forum is a hotbed of wall 


ay season. Usually we try to make sure content 
h is seasonally themed in this manner comes out 
n advance - for example, last year our Halloween 


conversations and problem-solving feature was in the October issue, which came out right 

for the community - join in via at the end of September. 

raspberrypi.org/forums Hopefully this explains why it happened and that it 
shouldn't occur too often. At least you now have a whole 


got my MagPi issue 51 today here in California, year to plan out your next Halloween projects! 
USA and there's a lot of good content; I 
enjoyed the ‘build a robot’ article. I see it 
promises ‘Spooky Halloween Projects’ on the cover, 
which seems an odd choice given the delivery date 
(1 November). Only 364 more days to go! 
jbeale 


HAVE 


Pi CAN BE MESSY. 
BUT IT DOESN'T 


TO BE. 


With a wide range of cables and 
enclosures for your Raspberry Pi 
projects and the WD PiDrive, WDLabs 
helps keep your creations properly 
powered and organized. 


wdlabs.wd.com/products 


WDLABS 


We've had a great year full of excellent Raspberry Pi kits 
and add-ons and other bits, a treasure trove for makers of 
all skill levels. We've put some of them into a mystery box 
that one lucky reader will be able to win. What's inside the 
box? You'll have to win it to find out... 


Tell us by 23 January Simply email competition @raspberrypi.org 
for your chance to win! with your name, address, and answer! 


Terms & Conditions 

Competition closes on 23 January 2017. Prize is offered worldwide to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize supplier, 
their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from the 
competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 
spam. Participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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Love your Pi? Love Music? 


Designed by audio experts, enjoyed by everyone 


Jaw dropping audio quality for your Raspberry Pi 

I))) Connect Headphones, Speakers, RCA, Toslink, S/PDIF or XLR 

Sonic P We work with all the major music solutions to ensure compatibility ma: 
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Twitter: @IQ_audio 


IQaudio Limited, 
Email: info@iqaudio.com | a U d | O Cricklade Wiltshire. 
Web: www.iqaudio.com Company No.: 9461908 


p — dian iS s 


J mindsensors.com 


a Think e Create @ Learn € Educate 


PIESGTORMS-vZ 


Make Stunning Robots with 
LEGOs and Raspberry Pi ! 


Column | THE FINAL WORD 


. todigital making in 2017 


floss my teeth every day. It's the only New 
Year's resolution that I’ve ever managed 

to keep, and I’ve now kept that promise to 
myself for many years. Admittedly ve made plenty 
of other resolutions, but they haven't managed 

to stick. Even so, with 2017 around the corner, 

I thought it would be fun to discuss some of the 
possible resolutions for all of us as digital makers. 

Of course, so many resolutions are a recommitment 
to healthier living, and there's no shortage of ways 
that digital making with Raspberry Pi can help 
us become healthier. In The MagPi issue 41, we 
featured Dot Silverman's Motivational Bathroom 
Scale project. It's a Raspberry Pi with a speaker 
hooked up to a bathroom scale. If you're not meeting 
your weight-loss goals, it'll berate you with sassy 
comments to motivate you to get back to the gym. 
You can, naturally, reprogram it to use positive 
reinforcement instead if you prefer. 

You could also use a Raspberry Pi Zero with an 
accelerometer to create your own pedometer, or hack 
your stationary bike so that you can only turn on the 
TV every day after you've cycled for 25 minutes. There 
are tons of ways that Raspberry Pi might be able to 
help you to live a healthier lifestyle. 

Along the lines of self-improvement, many people's 
resolutions relate to learning. As digital making and 
learning go hand-in-hand, there's an opportunity 
here to rededicate ourselves to learning more with 
Raspberry Pi. Try out a new programming language 
or Python library. Experiment with an electronic 
component you've never used. Learn to solder if you 
don't know how to already. Dedicating weekly time 
to gaining a deeper understanding of some aspect of 
technology is something I would like to do in 2017. 
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MATT RICHARDSON 


Matt is Raspberry Pi's US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 
and a contributing editor at Make: magazine. 


- Matt Richardson discusses how to rededicate yourself 


Even better than resolving to teach yourself 
something new, you can also make a commitment 
to teaching others. You could volunteer at your local 
Code Club, teach a workshop at a Raspberry Jam, 

or help your local school. You could even sit down 
with a friend or family member and show them 

a thing or two about Linux and programming. I 
would encourage you to use all the free educational 
resources on our site to help you do that. 


Be inspired 

Are there any projects on your shelf that remain 
unfinished? Perhaps it's time to take stock of those 
and commit to finishing them this year before taking 
on any new projects. Or if you're looking for new 
project ideas, ve found that getting into the habit of 
daily brainstorming helps a great deal. You can keep 
a notebook and write out a page of ideas every day. 

It doesn’t matter if they're practical or absolutely 
crazy. Just put pen to paper and get yourself thinking 
about what you want to make. I've found that when 
you get into the habit of challenging yourself to 
think creatively on a regular basis, the ideas start to 
come much more easily. 

There are many possible ways in which digital 
making and New Year's resolutions coalesce. Even if 
you're like me and you've broken more resolutions 
than you've kept, don't let that discourage you. It's 
certainly better to take stock of things and at least try 
to rededicate yourself to improvement as opposed to 
giving up before you've even started. In other words, 

a broken New Year's resolution is better than one not 
made at all. Even if you end up sticking to just one 
resolution out of 30, you're probably better off. I think 
at least my dentist would agree. 
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SB COMPONENTS 


CREATE YOUR OWN 
REMOTE CONTROLLED CAR 
OR OBSTACLE-SENSING ROBOT 


FEATURES INCLUDE: 


e Light-weight aluminium 
* Electric motors 
* Large wheels 


e Stackable chassis plates 


www.robots.sb-components.co.uk Call: 0203 514 0914 


At SB Components we strive to offer our customers the best prices 
for the best products. Our product team works tirelessly to source top 
quality affordable components from around the world. 


Raspberry Pi is a trademark of the Raspberry Pi Foundation Raspberry Pi not included 


WANT TO GET 
NOTICED? 
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AUDIENCE FAST Ma 


The MagP1 is the most exciting mag in tech today, boasting 
one of the biggest & most engaged audiences in the industry. c 
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serial Pi Plus 


RS232 serial communication board. 
Control your Raspberry Pi over RS232 
or connect to external serial 
accessories. 


Breakout PI Plus 


The Breakout Pi Plus is a useful 
and versatile prototyping expansion 
board for the Raspberry Pi 


ADC Differential Pi 


8 channel 18 bit analogue to digital 
converter. 1°C address selection 
allows you to add up to 32 analogue 
inputs to your Raspberry Pi. 


IO Pi Plus 


32 digital 5V inputs or outputs. 1°C 
address selection allows you to stack 
up to 4 IO Pi Plus boards on your 
Raspberry Pi giving you 128 digital 
inputs or outputs. 


HIC Pi Plus 


Real-time clock with battery backup 
and 5V I?C level converter for adding 
external 5V I?C devices to your 
Raspberry Pi. 


1 Wire Pi Plus 


1-Wire® to I?C host interface with ESD 
protection diode and I?C address 
selection. 


electronics 


AISO 
available 
tor the 
Pi Zero 


Cana 


The Perfect Holiday Gift! 


DUMMIES 


Build your own credit card 
sized computer 


Get started with programming 
Set up a Media Center 
Make simple electronic circuits 


Raspberry Pj board and Case 
Power Supply and HDMI cable 
Pre-Programmed Memory c 
Pa 40 electronic parts bs 
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FOR 


DU MIES 


A Wiley Brand 


Available for worldwide shipping at: 


raspberry Pi Kit 
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Available in Europe 
through RS Components 


$89? £69? 


US DOLLARS EXCLUDING VAT 


Raspberry Pi is a registered trademark of the Raspberry Pi Foundation. 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license. RS logo is 

a registered trademark of RS Components Ltd. CanakKit is a registered 
trademark of Cana Kit Corporation. 
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